# ADR NNNN: Title
- Status: proposed
- Date: YYYY-MM-DD
- Owners: @handle (or team)
## Context
What problem are we solving? What forces and constraints apply?
- Current behavior and pain points
- Requirements (functional, non-functional)
- Constraints (compatibility, Node versions, MCP protocol, transports, CI)
## Decision
What are we doing, specifically?
- The decision, stated as a clear commitment
- Scope of change (what is in / out)
- Interfaces/contracts impacted (tool params, schema, runtime state)
- Migration plan (if applicable) and the “remove legacy” criteria
## Alternatives considered
List realistic options and why they were not chosen.
1. Option A
2. Option B
3. Do nothing
## Consequences
What changes after this decision?
### Positive
- Expected benefits
### Negative / risks
- Tradeoffs, risks, and mitigations
### Follow-ups
- Concrete next steps (issues/PRs/plans)
## Validation
How do we prove this decision works?
- Commands to run (typecheck/lint/tests/validate:all)
- Runtime checks (STDIO/SSE smoke)
- Compatibility notes (CI matrix)
## References
- Related PRs/issues/plans
- Supersedes / superseded-by links (if applicable)
