Skip to content

ADR-NNN: [Short title]

Status: Proposed | Accepted | Superseded by ADR-XXX Source: prd.md §19 | prd-v2.1.md §C.8 | prd-v2.1.md §B.15 | new Date: YYYY-MM-DD

Context

What is the issue motivating this decision? Cite specific PRD sections, lessons-learned entries, or runtime observations that triggered the decision.

Decision

What is the change we are making? Be concrete — file paths, code constructs, library choices, behavior contracts. Numbered list when there are multiple sub-decisions.

Consequences

What becomes easier? Harder? What new constraints does this introduce? What does this NOT cover (explicit non-scope)?

  • Positive consequence
  • Negative consequence / new constraint
  • Out-of-scope

Cross-references