What problem does it solve?
Creates new Architecture Decision Record (ADR) documents for significant architectural changes using a consistent template and repository-aware naming and storage guidance. Use when a user or agent decides on an architectural change, needs to document technical rationale, or wants to add a new ADR to the project history.
Core Features & Use Cases
- ADR drafting: from discovery to final Markdown using standard sections.
- Conventions discovery: inspects repository for ADR location and naming patterns, or defaults to docs/architecture/adr with zero-padded filenames like 0001-<title>.md.
- Guided workflow: prompts for Title, Status, Context, Decision, and Consequences, and ensures you are creating a new ADR (not editing an existing one).
- Use Case: Document major architectural decisions to preserve history and rationale.
Quick Start
Provide the ADR details (title, context, decision, and consequences) and let the skill draft and save a new ADR file in the repository’s ADR location.