Objective#
[Define the completed behavior.]
Context#
[Summarize current behavior and verified repository evidence.]
Known facts#
- [Verified fact.]
Assumptions#
- [Assumption and how it will be validated.]
Scope#
- [Included change.]
Out of scope#
- [Explicit exclusion.]
Research findings#
- [Primary-source finding, link, and implementation consequence.]
Acceptance criteria#
- [Observable criterion.]
Proposed approach#
[Describe the smallest coherent solution.]
Decisions#
- [Confirmed implementation choice and why it was selected.]
Files likely affected#
| Path | Expected change | Evidence |
|---|---|---|
| [Path] | [Change] | [Why this file is involved] |
Ordered steps#
- [Action, boundary, and validation.]
- [Action, boundary, and validation.]
Risks#
| Risk | Mitigation | Stop condition |
|---|---|---|
| [Risk] | [Mitigation] | [Condition] |
Validation strategy#
- [Command or observation mapped to an acceptance criterion.]
Rollback or recovery#
[Explain the smallest safe reversal or recovery path.]
Approval-sensitive operations#
- [Remote or destructive action, exact target, and whether approved.]
Unresolved questions#
- [Material question remaining before implementation.]