Can I use this for existing codebases?

Absolutely. You can use the skill to document current architectural patterns or to define the technical path for a new major feature within an existing repo.

What is an Architecture Decision Record (ADR)?

An ADR is a document that captures a critical architectural decision, including its context, alternatives considered, and consequences, to provide a historical record for the development team.

How does this skill help prevent over-engineering?

The skill includes specific rules to challenge complex solutions, such as recommending simpler hosting or database options if they are more appropriate for an MVP timeline.

Where are the architecture files stored?

This skill automatically organizes documentation within your repository in the docs/architecture/ and docs/decisions/ directories.

Do I need an existing project description to use this?

Yes, the skill works best when a docs/project.md file exists. If it doesn't, Claude will suggest an interview to define the project goals first.

Architecture Designer

Name: Architecture Designer
Author: edumesones

byedumesones

0•

클라우드 인프라

Defines technical architectures and generates comprehensive Architecture Decision Records (ADRs) through a structured interview process.

Architecture Designer is a specialized Claude Code skill designed for the 'Phase 0' of software development. It transforms vague project requirements into a concrete technical foundation by guiding users through key architectural decisions—such as language selection, database modeling, and hosting strategy—while providing trade-offs and recommendations. By automating the creation of Architecture Decision Records (ADRs) and high-level system overviews, it ensures that technical choices are documented, justified, and aligned with project constraints like MVP timelines or scalability needs.

주요 기능

01Active prevention of over-engineering for MVP development

02Interactive architectural interviewing with trade-off analysis

03Automated generation of standardized Architecture Decision Records (ADRs)

04Context-aware recommendations based on project goals and team size

05Creation of centralized system overviews and tech stack documentation

060 GitHub stars

사용 사례

01Bootstrapping a new software project with a documented technical foundation

02Formalizing technical choices during a migration or system refactor

03Standardizing documentation to ensure team alignment on architectural patterns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add edumesones/azure--demo architecture-designer

For use in Claude.ai and ChatGPT

Download Skill