adr-engineering
Installation
SKILL.md
ADR Engineering
Use this skill when
- Capturing the why behind technical decisions
- Reviewing past decisions and alternatives
- Onboarding context
Do not use this skill when
- Trivial implementation details
- A stale doc nobody updates (keep lean)
Instructions
- Title the ADR with the decision, not the debate.
- Include context, decision, alternatives considered, and trade-offs.
- Date and number ADRs; link superseded ones.
- Keep ADRs short enough to stay maintained.
- Add status: proposed, accepted, superseded.
- Review ADRs at design checkpoints, not after.