Synopsis
Pass the ball to your counterpart agent and append a handoff entry to the thread. This is a clean way to transfer ownership with context.Usage
Arguments
Thread topic identifier
Optional Parameters
Threads directory path. Defaults to
./watercooler or $WATERCOOLER_DIR.Agent performing the handoff. Defaults to “Team” if not specified.
Agent role. Defaults to
pm. Valid values: planner, critic, implementer, tester, pm, scribeOptional custom handoff message explaining the transfer
Path to agent registry JSON file
Examples
Basic handoff
Handoff with custom message
Handoff from specific role
Handoff with agent specification
Review handoff
Expected Output
The command prints the path to the updated thread file:- A new handoff entry with timestamp
- Ball ownership transferred to counterpart
- Optional note included in entry body
Ball Mechanics
Thehandoff command:
- Automatically flips the ball to the counterpart
- If ball was with
codex, moves tohuman - If ball was with
human, moves tocodex - Creates a clear record of the transfer
Default Role
The default role for handoff ispm (project manager), as handoffs typically represent:
- Work completion checkpoints
- Phase transitions
- Coordination between agents
--role if the handoff is from a different perspective.