The challenge
Choose a repository with tests and add one scoped improvement: a filter, empty state, validation, or small command. It should fit within one reviewable session.
Phase 1: understand
Do not edit yet. Trace current behavior, locate patterns and tests, read repository instructions, and propose a plan of at most five steps with risks.
Phase 2: build
Implement the approved plan with the smallest change. Add or adjust a test that protects the behavior. Preserve unrelated work and follow existing conventions.
Phase 3: verify
Run focused tests, lint, and build. Manually inspect the flow when UI is involved. Review the diff and fix regressions before summarizing.
Rubric
- Scope: the diff contains only the requested improvement.
- Correctness: the test protects the behavior and passes.
- Quality: the code fits the repository and avoids duplicate solutions.
- Security: no secrets or unnecessary permissions appear.
- Handoff: the summary separates verified facts from remaining risks.
Finish
End with git status, the diff, executed commands, and a self-review. Only then create a commit with one clear idea. The goal is not more code, but a change another programmer can trust and maintain.