ADR — Development skill for Claude Code
Architecture Decision Records.
How to install ADR
Installs to ~/.claude/commands/sahin-ai-rules-adr.md
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/sahin/ai-rules/HEAD/.claude/commands/adr.md -o ~/.claude/commands/sahin-ai-rules-adr.md Restart Claude Code, or start a new session, for it to be picked up.
What ADR does
Architecture Decision Records
Use this guide when making significant architectural decisions that affect the project long-term.
When to Create an ADR
Create an ADR when:
- Choosing a framework, library, or major dependency
- Changing the project's architecture or patterns
- Making a decision that would be costly to reverse
- Resolving a technical debate within the team
- Deviating from established conventions
Do NOT create an ADR for:
- Routine coding decisions
- Bug fixes
- Minor depen
Alternatives in Development
- 10 Colonial Records Search — Colonial Records Search 1.1k ★
- ADR Rubber Duck — ADR(Architecture Decision Record)の壁打ち相手としてヒアリングを通じて意思決定を整理し、ADRドラフトを作成する 974 ★
- Projectmem — Open-source coding agent memory 766 ★
Full documentation available on GitHub
View Source RepositoryRelated Skills
Architecture Decision Records
Capture architectural decisions made during coding sessions as structured ADRs. Auto-detects decision moments,
Madr
Analyze the current session and suggest mADR (Architecture Decision Record) updates or new records
V ADR
Capture one genuine architecture decision as a thin, human-confirmed ADR under docs/superpowers/adr/NNNN-slug.
Create ADR
Record an architecture decision with rigorous alternatives analysis and honest consequences. For high-switchin
Hef.Adr
Record an architecture decision as a report with machine-readable MADR status
Simone Create ADR
/simone-create-adr - Create Architecture Decision Record
Related Agents
ADR Drafter
Drafts Architecture Decision Records (ADRs) from a decision prompt or discussion. Structures rationale, altern
ADR Writer
Create Architecture Decision Records (ADRs) to document significant technical decisions. Use when choosing bet
Create ADR
Cria Architecture Decision Records (ADRs) para registrar decisões arquiteturais do — escolhas de tecnologia, p