Agent skill
architecture-decision-recorder
Create and manage Architecture Decision Records (ADRs) for documenting important architectural decisions, tradeoffs, and rationale.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/architecture-decision-recorder
SKILL.md
Architecture Decision Recorder
Systematically document architectural decisions using the ADR pattern.
When to Use
- Documenting significant architectural decisions
- Recording technology choices
- Tracking design tradeoffs
- Maintaining architectural history
- Facilitating team communication
ADR Template
# ADR-NNNN: [Title]
**Date:** YYYY-MM-DD
**Status:** [Proposed | Accepted | Deprecated | Superseded]
**Decision Makers:** [Names]
## Context
What is the issue we're trying to solve? What are the forces at play?
### Business Context
- Business goal or requirement
- Constraints (time, budget, team)
- Stakeholder concerns
### Technical Context
- Current system state
- Technical constraints
- Integration requirements
## Decision
We will [decision statement].
### Rationale
Why this approach over alternatives?
## Consequences
### Positive
- Benefit 1
- Benefit 2
### Negative
- Tradeoff 1
- Tradeoff 2
### Risks
- Risk 1 → Mitigation strategy
- Risk 2 → Mitigation strategy
## Alternatives Considered
### Option 1: [Name]
**Pros:** [List]
**Cons:** [List]
**Rejected because:** [Reason]
### Option 2: [Name]
**Pros:** [List]
**Cons:** [List]
**Rejected because:** [Reason]
## Implementation
- [ ] Action item 1
- [ ] Action item 2
## References
- [Link to research]
- [Related ADR]
Best Practices
- ✅ Create ADRs for all major decisions
- ✅ Keep ADRs immutable (supersede, don't edit)
- ✅ Store in version control
- ✅ Link related ADRs
- ✅ Review quarterly
- ✅ Include quantitative data
Related Commands
/adr-create- Create new ADR
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?