| name | handoff |
| requires_protocol | >=0.6.0,<0.7.0 |
| description | Use when the user invokes `$handoff`, asks for a handoff, or asks to finish a team-collab session by updating CURRENT/NEXT/RISKS/TODO and syncing docs. |
Team Collab Handoff
This is a Codex-friendly command wrapper. Codex does not currently support arbitrary custom top-level slash commands like /handoff, so the supported Codex entry point is:
$handoff <topic>
Required behavior
- Treat any text after
$handoff as the handoff topic.
- Immediately follow the installed
team-collab-protocol skill and its references/handoff.md flow.
- If the
team-collab-protocol skill is not available in the current session, read it from:
~/.codex/skills/team-collab-protocol/SKILL.md
- If that file is missing, stop and tell the user to run:
team-collab install-skills --agent codex --force
- Do not improvise a partial handoff from this wrapper alone. The protocol references own git sync, empty-session checks, state-quartet updates, sensitive-data rules, conflict handling, commit, and push behavior.
Compatibility note
If a future Codex version supports custom slash commands and /handoff reaches the model as plain user text, handle it exactly the same way as $handoff.
