Architecture decision records
Skill charlieviettq/awesome-agent-skill/.claude/skills/architecture-decision-records
Create and maintain Architecture Decision Records (ADRs) for significant technical choices—frameworks, data stores, API shapes, ML platform decisions. Use when documenting a decision, onboarding, or superseding a prior approach.From its SKILL.md
npx -y skills add charlieviettq/awesome-agent-skill --skill architecture-decision-recordsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 22 stars22 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
1.7 KB, 327 tokens by cl100k_base, as published. Nobody here has run it
Architecture decision records
When to write an ADR
| Write ADR | Skip ADR |
|---|---|
| New framework or major dependency | Minor version bump |
| Database or storage choice | Bug fix |
| API or integration pattern | Config-only change |
| Security or auth architecture | Routine maintenance |
Lifecycle
Proposed -> Accepted -> Deprecated -> Superseded
Do not rewrite accepted ADRs; add a new ADR that supersedes the old one.
Required sections
- Context — problem and constraints
- Decision — what was chosen (one clear statement)
- Consequences — positive, negative, risks and mitigations
- Status and date
Optional (recommended for significant decisions)
- Decision drivers (numbered)
- Considered options with honest pros/cons
- Related ADRs / links
Lightweight template
# ADR-NNNN: Title
**Status:** Accepted | **Date:** YYYY-MM-DD
## Context
[Why we needed to decide]
## Decision
[What we decided]
## Consequences
**Positive:** ...
**Negative:** ...
**Risks:** ... **Mitigation:** ...
Full MADR-style templates
See reference.md for extended templates (standard, Y-statement, deprecation).
Practices
- Write before implementation starts when possible.
- Keep ADRs short (1-2 pages); link deep dives elsewhere.
- Be honest about trade-offs.
What ships with it: 1 file
677 B alongside SKILL.md
- reference.md677 B