submit_handoff
Submit a structured handoff with status, completed items, and issues when finishing a delegated task, enabling the orchestrator to parse and decide next steps.
Instructions
Submit a structured handoff to an orchestrator or other recipient peer. Use this when finishing a delegated task (worker -> orchestrator, validator -> orchestrator, etc.) instead of free-form route_to_peer text. The hub persists the full structured payload as a Handoff tail event for audit AND routes a serialized JSON version to the recipient peer so their CC sees it as a turn input. Pairs with the missions-orchestrator pattern: orchestrator spawns ephemeral worker, worker implements feature, worker calls submit_handoff with status + completed[] + issues[] etc., orchestrator parses the JSON and decides next step. Returns the JSON string the recipient will see so you can confirm shape.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Optional free-form prose for context that doesn't fit the structured fields. | |
| issues | No | Problems the orchestrator should know about: pre-existing breakages you noticed, ambiguous requirements, security concerns, etc. | |
| status | Yes | completed = every assertion / procedure satisfied. partial = work done but some items skipped (must populate skipped[]). failed = unrecoverable, requires orchestrator intervention. | |
| toPeer | Yes | Recipient peer routing name (e.g. "@orchestrator-passwordreset"). The recipient receives a serialized JSON string as their turn input. | |
| skipped | No | List of {item, reason} for anything deferred. | |
| fromRole | Yes | Which role you played while doing the work. | |
| completed | No | Bullet list of what got implemented / verified / shipped. | |
| featureId | Yes | Which feature this handoff covers (from the orchestrator's features.json). | |
| missionId | Yes | Free-form mission correlation id. Pass the same value the orchestrator gave you when it spawned you. | |
| commandsRun | No | Each significant shell command you ran, its exit code, optional last ~20 lines of stdout/stderr for diagnostics. | |
| proceduresHonored | No | Which of the orchestrator-defined procedures (numbered steps in your prompt) you actually followed. |