Terms in this guide: Acceptance criteria · Verification
Reliable agent-assisted work is a sequence of small decisions. This workflow keeps the request, investigation, implementation, and evidence connected so the final patch is easier to trust.
1. Translate the issue into behavior
Write the current behavior, desired behavior, and conditions that trigger the problem. Separate observed facts from guesses about the cause.
2. Inspect before editing
Ask Codex to locate the relevant path, read nearby tests and instructions, and present the smallest plausible plan. A plan is useful when it makes scope and assumptions visible.
3. Implement and verify
Make the focused change, add a test when it protects meaningful behavior, and run checks in increasing scope. Review the final diff for accidental churn before recording the result.
- Focused reproduction or test passes.
- Related tests still pass.
- The diff contains only intended files.
- The summary names any check that could not run.
Official references
Continue with a practical next step
Progress stays in this browser. No account needed.
Updates and upgrade guidance
- Learning context added
Added prerequisites, a suggested practice estimate, expected output, and connected definitions. The article procedure was not independently re-evaluated in this change.
What to do: Use the opening checklist to prepare. No software update is required for this editorial change.
This log starts with the first recorded review; it is not a reconstruction of earlier revisions.