architecture▌
davila7/claude-code-templates · updated Apr 8, 2026
Framework for analyzing requirements, evaluating trade-offs, and documenting architectural decisions.
- ›Guides context discovery through structured questions and project classification before design begins
- ›Provides ADR templates and trade-off analysis framework for capturing decision rationale and alternatives
- ›Includes decision trees and anti-pattern guidance for selecting appropriate architectural patterns
- ›Emphasizes simplicity-first approach: add complexity only when proven necess
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 |
🔗 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
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.8★★★★★44 reviews- ★★★★★Ama Khanna· Dec 24, 2024
Registry listing for architecture matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Shikha Mishra· Dec 20, 2024
I recommend architecture for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Ganesh Mohane· Dec 16, 2024
We added architecture from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Daniel Garcia· Dec 12, 2024
Useful defaults in architecture — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Aisha Ndlovu· Nov 15, 2024
architecture fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Yash Thakker· Nov 11, 2024
Useful defaults in architecture — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Harper Thomas· Nov 3, 2024
I recommend architecture for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Harper Li· Oct 22, 2024
architecture reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Aisha Brown· Oct 6, 2024
architecture is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Dhruvi Jain· Oct 2, 2024
architecture has been reliable in day-to-day use. Documentation quality is above average for community skills.
showing 1-10 of 44