
Architecture Decision Framework
FreeStreamline your architectural decision-making process.
Free ยท Opens the source repo
What Architecture Decision Framework does
The Architecture Decision Framework skill provides a structured approach to making architectural decisions in software development. It emphasizes the importance of requirements analysis and trade-off evaluation, ensuring that each decision is well-documented and justified. This skill is particularly useful for teams looking to establish a clear rationale behind their architectural choices, which can be invaluable for future reference and team alignment.
This skill includes several key components, such as the context-discovery.md file, which offers essential questions to guide the project classification and initial architecture design. The trade-off-analysis.md file contains templates and frameworks to document decisions and evaluate trade-offs effectively. Additionally, the pattern-selection.md file helps users choose appropriate design patterns while avoiding common anti-patterns. The skill also provides practical examples through the examples.md file, showcasing implementations for various scenarios like MVP, SaaS, and enterprise applications.
By adhering to the core principle of simplicity, the framework encourages teams to start with straightforward solutions and introduce complexity only when necessary. This approach not only facilitates easier decision-making but also helps in maintaining a clean architecture that can evolve over time without becoming overly complicated. The validation checklist ensures that all critical aspects of the architecture are considered before finalization, promoting thoroughness and clarity in the decision-making process.
This skill is ideal for software architects, developers, and project managers who are involved in system design and architecture decisions. It serves as both a reference guide and a practical toolkit for improving architectural practices within teams, making it easier to document and communicate decisions effectively.
When to use it
Use this skill when starting a new architecture project or when significant architectural decisions need to be made or documented.
When not to use it
This skill may not be suitable for very small projects or teams that prefer less formalized approaches to architecture.
What you can build with it
Starting a New Project
When initiating a new software project, use this framework to establish clear requirements and make informed architectural decisions.
Documenting Existing Decisions
Apply the framework to document and analyze architectural decisions made in ongoing projects, ensuring clarity and rationale for future reference.
Evaluating Architectural Trade-offs
Utilize the trade-off analysis templates to systematically assess different architectural approaches and their implications on project goals.
How to install Architecture Decision Framework
View source1. Install with the skills CLI
npx skills add davila7/claude-code-templates/architecture --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by davila7Architecture Decision Framework
"Requirements drive architecture. Trade-offs inform decisions. ADRs capture rationale."
๐ฏ Selective Reading Rule
Read ONLY files relevant to the request! Check the content map, find what you need.
| File | Description | When to Read |
|---|---|---|
context-discovery.md | Questions to ask, project classification | Starting architecture design |
trade-off-analysis.md | ADR templates, trade-off framework | Documenting decisions |
pattern-selection.md | Decision trees, anti-patterns | Choosing patterns |
examples.md | MVP, SaaS, Enterprise examples | Reference implementations |
patterns-reference.md | Quick lookup for patterns | Pattern comparison |
๐ Related Skills
| Skill | Use For |
|---|---|
@[skills/database-design] | Database schema design |
@[skills/api-patterns] | API design patterns |
@[skills/deployment-procedures] | Deployment architecture |
Core Principle
"Simplicity is the ultimate sophistication."
- Start simple
- Add complexity ONLY when proven necessary
- You can always add patterns later
- Removing complexity is MUCH harder than adding it
Validation Checklist
Before finalizing architecture:
- Requirements clearly understood
- Constraints identified
- Each decision has trade-off analysis
- Simpler alternatives considered
- ADRs written for significant decisions
- Team expertise matches chosen patterns
Frequently asked questions about Architecture Decision Framework
Similar skills
Spring Boot Testing
Master testing techniques for Spring Boot 4 applications.
GitHub Issues
Manage GitHub issues efficiently with MCP tools.
Geofeed Tuner
Optimize your IP geolocation feeds in CSV format.
Batch Files
Master Windows batch scripting for automation and task management.
Adobe Illustrator Scripting
Automate your Illustrator workflows with ExtendScript.
Plugin Structure
Create and organize Claude Code plugins effectively.
