adr

name	adr
description	Create Architecture Decision Records. Activated when the user mentions ADR, architectural decision, or technical trade-off.
allowed tools	Read, Write, Glob

Architecture Decision Records

Template

Create in docs/architecture/adr-NNN-title.md:

# ADR-NNN: Decision Title

## Status
Proposed | Accepted | Deprecated | Superseded by ADR-XXX

## Context
What motivated this decision? What problem are we solving?

## Decision
What we decided to do and why.

## Alternatives considered
1. **Alternative A** — pros and cons
2. **Alternative B** — pros and cons

## Consequences
- Positive: ...
- Negative: ...
- Risks: ...

## Impact on specs
[SPEC] List affected specs:
- Compliance: [impact]
- Security: [impact]
- Scalability: [impact]
- [others]

## References
- PRD: `docs/product/xxx.md`
- Design: [link]

Rules

• Number sequentially (check last number with ls docs/architecture/)
• Accepted ADRs are immutable — create a new ADR to supersede
• Always link to the PRD that motivated the decision