| name | handoff |
| description | Codex handoff checklist for agents. |
Handoff
Purpose: package the current state so the next agent (or future you) can resume quickly.
Include (in order):
- Scope/status: what you were doing, what’s done, what’s pending, and any blockers.
- Working tree:
git status -sbsummary and whether there are local commits not pushed. - Branch/PR: current branch, relevant PR number/URL, CI status if known.
- Running processes: list tmux sessions/panes and how to attach:
- Example:
tmux attach -t codex-shellortmux capture-pane -p -J -t codex-shell:0.0 -S -200 - Note dev servers, tests, debuggers, background scripts, and how to stop them.
- Example:
- Tests/checks: which commands were run, results, and what still needs to run.
- Changelog + docs: mention if
CHANGELOG.mdor docs were updated and why (not the sole source of truth). - Next steps: ordered bullets the next agent should do first.
- Risks/gotchas: any flaky tests, credentials, feature flags, or brittle areas.
Output format: concise bullet list; include copy/paste tmux commands for any live sessions.