templates/change-record.md

# Change — <short title>

- **When:** <date/time or durable timestamp>
- **Actor / agent:** <known identity/tool or unknown>
- **Request / source:** <issue, prompt, incident, requirement, ADR>
- **Status:** <implemented | reverted | superseded>

## Affected

- Code/components: <paths and surfaces>
- Product/business surfaces: <who/what is affected>

## Before

<What was true before.>

## Change

<What changed.>

## Now

<What is true after the change.>

## Why

<Problem, evidence, business intent and product intent.>

## Technical reasoning

<Why this implementation; alternatives and trade-offs.>

## Compatibility / migration / rollback

<Compatibility, data/schema impact, migration and rollback.>

## Knowledge delta

- Rules: <links or none>
- Skills: <links or none>
- Failures/lessons: <links or none>
- ADRs: <links or none>
- Product/business/architecture/ops/context/memory: <links or none>

## Verification

<Tests/checks/evidence actually observed.>

## Future

<Follow-ups or future intent. Explicitly say none if none. Do not present future work as implemented.>

## Stale when

<What event requires current-state claims in this record to be reverified.>