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 -sb summary 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-shell or tmux capture-pane -p -J -t codex-shell:0.0 -S -200
- Note dev servers, tests, debuggers, background scripts, and how to stop them.
- Tests/checks: which commands were run, results, and what still needs to run.
- Changelog + docs: mention if
CHANGELOG.md or 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.