What problem does it solve?
Architectural decisions shape the long-term health of a codebase, but are often poorly documented or scattered across ad-hoc notes. This skill provides an interactive workflow to create, update, and reference Architectural Decision Records (ADRs) stored in wiki/adrs/, preserving reasoning, context, and consequences for future developers.
Core Features & Use Cases
- ADR creation: Generate new ADRs with context, decision, and consequences, automatically linking to related wiki modules.
- Status tracking: Update ADR status (proposed, accepted, superseded, deprecated) and cross-reference with related decisions.
- Guided interviewing: Interactive prompts collect essential fields (Context, Decision, Consequences, Files to modify) and ensure consistency across ADRs.
- Use Case: When planning a major refactor, create an ADR to document rationale and expected impact before changes occur.
Quick Start
Trigger the adr workflow with /adr [title] to begin a new ADR in wiki/adrs/ and respond to prompts to capture context, decision, consequences, and files to modify.