What problem does it solve?
Architecture decisions are often scattered in meetings and PRs. This skill provides a structured, reproducible way to capture rationale, alternatives, and consequences as formal ADR documents.
Core Features & Use Cases
- Structured ADR templates: Generates ADR documents in docs/ai/adr/{NNN}-{slug}.md with sections for Context, Decision, and Consequences.
- Numbering & traceability: auto-increments ADR numbers by scanning existing docs/ai/adr entries, ensuring unique IDs.
- Research & justification: Guides researchers to collect context, forces consideration of trade-offs, and records decisions for future reference.
- Future extensions: Supports ASCII diagrams and linkable references to related code/docs.
Quick Start
Create a new ADR document for the proposed feature and save it under docs/ai/adr as ADR {NNN}-{slug}.md.