Architecture decision records
SkillAI & modelsCreate 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.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Architecture decision records skill
What this skill tells your AI
The instructions your AI receives, as published by charlieviettq/awesome-agent-skill in .claude/skills/architecture-decision-records/SKILL.md and read by ahel’s review.
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.
Signals
- GitHub stars
- 26
- Forks
- 9
- Last commit
- Jul 2026
Advanced
- Catalog kind
- skill
- Gateway key
architecture-decision-records-charlieviettq- Source
- github.com/charlieviettq/awesome-agent-skill