New to Claude Skills? Learn how to install them โ†’

Adavila7 on GitHub

Architecture Decision Framework

Free

Streamline your architectural decision-making process.

Get this skill

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 source

1. Install with the skills CLI

npx skills add davila7/claude-code-templates/architecture --agent claude-code

2. 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 davila7

Architecture 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.

FileDescriptionWhen to Read
context-discovery.mdQuestions to ask, project classificationStarting architecture design
trade-off-analysis.mdADR templates, trade-off frameworkDocumenting decisions
pattern-selection.mdDecision trees, anti-patternsChoosing patterns
examples.mdMVP, SaaS, Enterprise examplesReference implementations
patterns-reference.mdQuick lookup for patternsPattern comparison

๐Ÿ”— Related Skills

SkillUse 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