Fix one reproducible defect. Name the failing input, relevant module, current branch, and out-of-scope files. The regression should fail before the patch and pass after it. Report the cause, files, tests, and residual risk.
Objective
fix one reproducible defect.
Context
issue, failing input, relevant module, current branch.
Instructions
reproduce first, identify the smallest cause, avoid unrelated refactors.
Decompose
reproduce, add regression test, patch, run focused and adjacent tests.
Criteria
regression fails before the patch and passes after; no new warnings.
Files/tools
named module and test, search, test runner.
Review/security
inspect boundary validation and error handling.
Commit/rollback
one focused commit; revert commit if needed.
Output
cause, files, tests, residual risk.
Handoff checklist
- Objective and failing input are explicit
- Regression test fails before the fix
- Diff is one reversible unit
- Focused and adjacent tests pass
Editorial recipe adapted from the project’s September 2026 research brief. Commands, authority and acceptance tests must be matched to your repository. No production execution is implied.