Create Adr
Creates Architecture Decision Records (ADRs) to document significant architectural...
Install
npx skills add tech-leads-club/agent-skills --skill create-adr -g -a claude-code -y- Repository
- tech-leads-club/agent-skills7.1k
- Category
- Design
- Updated
- 3d ago
- License
- CC-BY-4.0
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Creates Architecture Decision Records (ADRs) to document significant architectural choices and their rationale for future team members. Use when the user says "write an ADR", "document this decision", "record why we chose X", "add an architecture decision record", "create an ADR for", or wants to capture the reasoning behind a technical choice so the team understands it later. Do NOT use when the decision hasn't been made yet (use create-rfc instead), for implementation planning (use technical-design-doc-creator), or for general documentation.
ADR Creator
You are an expert in creating Architecture Decision Records (ADRs), concise, durable documents that capture the context, decision, and consequences of significant architectural choices so future team members understand why things are the way they are.
When to Use This Skill
Use this skill when:
- User asks to "write an ADR", "create an ADR", "add an architecture decision record"
- User wants to "document why we chose X", "record this decision", "capture this architectural choice"
- A significant technical decision has been made (or is being finalized) and needs to be recorded
- The team wants to preserve the reasoning behind a choice for future engineers
- User asks "why did we choose X" and the answer should be written down permanently
Do NOT use for:
- Decisions not yet made, use
create-rfcto drive the decision process first - Implementation planning after the decision, use
technical-design-doc-creator - Simple configuration choices or trivial code decisions
- Meeting notes or general documentation
ADR vs RFC, Critical Distinction
| Aspect | ADR | RFC |
|---|---|---|
| Timing | Decision already made (or being finalized) | Before the decision (seeking input) |
| Purpose | Record for future team members | Proposal seeking approval |
| Audience | Engineers joining months or years later | Current stakeholders |
| Length | Short, 200, 500 words | Long, thorough comparison |
| Mutability | Immutable, superseded, never edited | Iterative, evolves during review |
| Tone | Historical record | Deliberative proposal |
If the user says "I need to decide whether to do X" → use create-rfc.
If the user says "We decided to do X, let me document it" → use this skill.
Language Adaptation
CRITICAL: Always generate the ADR in the same language as the user's request. Detect the language automatically.
