A good agent-assisted bug fix starts with evidence: the failure, expected behavior, relevant constraints, and the exact proof that would show the root cause is gone.
Prerequisites
Connect the affected repository and write a card with the shortest reliable reproduction, logs or a failing test, expected behavior, edge cases, and a bounded definition of done. If the root cause is not yet clear, add a read-only Research step before implementation.
Suggested sequence
Use the focused-fix starter recipe for a Codex implementation followed by Reviewer, or build a recipe that adds QA for behavior-heavy regressions.
- Reproduce and identify the root cause
- Implement the smallest durable change
- Add focused regression coverage
- Review the patch against the original evidence
Artifacts and controls
The team reviews the branch, diff, tests, preview when useful, and pull request. Unrelated refactors, unverified assumptions, and missing coverage remain reasons to request changes rather than merge.