| name | new-adr |
|---|---|
| model | reasoning |
| description | Create a new Architecture Decision Record |
| usage | /new-adr <title> |
Create a new Architecture Decision Record.
/new-adr <title>
Arguments:
title— Decision title (kebab-case, descriptive)
/new-adr authentication-approach
/new-adr database-selection
/new-adr caching-strategy
/new-adr api-versioning
- Scans
docs/decisions/to determine next ADR number - Creates new file
docs/decisions/[number]-[title].md - Fills in template with title and number
- Prompts for context (what problem are we solving?)
- Guides through decision capture
# ADR-[NUMBER]: [Title]
## Status
Proposed | Accepted | Deprecated | Superseded
## Context
[What is the issue we're solving? What constraints exist?]
## Decision
[What did we decide? Be specific about the choice made.]
## Consequences
[Results - positive and negative. What becomes easier? Harder?]
## Alternatives Considered
[Other options evaluated and why they were rejected]| Status | Meaning |
|---|---|
| Proposed | Under discussion |
| Accepted | Implemented and active |
| Deprecated | No longer recommended |
| Superseded | Replaced by another ADR |
- ADR file →
docs/decisions/[number]-[title].md
- Feature development:
/new-feature(often triggers ADR) - Docs structure:
/bootstrap-docs(sets up decisions/) - Agent:
ai/agents/development/