adr-documentation
SKILL.md
ADR Documentation
Overview
What are ADRs?
Architecture Decision Records (ADRs) are lightweight documents that capture important architectural decisions along with their context and consequences. They serve as a historical record of why certain choices were made, helping teams avoid revisiting settled debates and providing context for future developers.
Key characteristics:
- Immutable: Once accepted, ADRs are rarely modified (supersede instead)
- Context-rich: Capture the environment and constraints at decision time
- Outcome-focused: Document what was decided and why
- Alternative-aware: Show what options were considered and rejected