Architecture

A lightweight framework for making and documenting architecture decisions without overthinking them. Guides you through requirements analysis, trade-off evaluation, and writing ADRs. The core philosophy is refreshingly pragmatic: start simple, add complexity only when necessary, and document why you made each choice. Includes decision trees for pattern selection, anti-pattern warnings, and examples ranging from MVPs to enterprise systems. Works with Read, Glob, and Grep to analyze your existing codebase. Best used when you're tempted to reach for microservices on day one or need to explain to future you why you chose boring technology.

skills.sh installs: 555
GitHub stars: 33.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add davila7/claude-code-templates --skill architecture --agent claude-code

Installs into .claude/skills of the current project.

Files

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.

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