b723e2bd7d
- Created skills/ directory - Moved 272 skills to skills/ subfolder - Kept agents/ at root level - Kept installation scripts and docs at root level Repository structure: - skills/ - All 272 skills from skills.sh - agents/ - Agent definitions - *.sh, *.ps1 - Installation scripts - README.md, etc. - Documentation Co-Authored-By: Claude <noreply@anthropic.com>
56 lines
1.7 KiB
Markdown
56 lines
1.7 KiB
Markdown
---
|
|
name: architecture
|
|
description: Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design.
|
|
allowed-tools: Read, Glob, Grep
|
|
---
|
|
|
|
# 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
|