What is the output format?

The primary output is a structured architecture.md file located in your project's documentation folder or BMAD output directory.

Which cloud providers are supported?

The skill provides tailored recommendations for AWS, Google Cloud (GCP), Azure, and self-hosted/on-premise environments based on your selection.

Does it generate diagrams?

Yes, it generates multiple Mermaid diagrams, including C4 system context diagrams, component maps, and data flow visualizations.

What inputs does the Architect skill require?

The skill primarily uses reverse-engineering (RE) documents, such as data architecture and integration point summaries, to understand the current system context before proposing a new design.

Can I use this for greenfield projects?

Yes. While it excels at evolving existing systems, you can provide functional specifications and use the interactive prompts to define an architecture for a brand new project.

StackShift Architect

Name: StackShift Architect
Author: jschulte

byjschulte

•

Cloud Infrastructure

Generates comprehensive system architecture documentation and Mermaid diagrams from existing code analysis and user requirements.

StackShift Architect is a specialized Claude Code skill designed to bridge the gap between reverse engineering and system design. It systematically analyzes existing project artifacts to produce a professional-grade architecture.md file complete with service boundaries, infrastructure recommendations, and cost estimates. The skill guides users through a structured consultation on tech stacks, cloud providers, and scaling strategies to create a cohesive blueprint that includes Architecture Decision Records (ADRs) and Mermaid C4 diagrams. Whether you are modernizing a legacy system or planning a new feature, this skill ensures your technical design is documented, justified, and ready for implementation.

Key Features

01Visual system modeling using Mermaid C4 notation and data flow diagrams

02Seamless integration with the BMAD (Business-Driven Model-Actor-Design) workflow

03Interactive configuration for tech stack, cloud provider, and scale targets

041 GitHub stars

05Automated generation of detailed architecture.md documentation

06Creation of Architecture Decision Records (ADRs) to document design rationale

Use Cases

01Modernizing legacy applications by documenting the current state and defining a target migration path

02Bootstrapping professional-grade architectural blueprints for new MVPs or enterprise projects

03Generating visual infrastructure and component diagrams for technical stakeholder reviews

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jschulte/claude-plugins architect

For use in Claude.ai and ChatGPT

Download Skill