Record handoff summary
record_handoff_summaryRecord a structured handoff summary with context, next steps, and blockers to transfer work between agents or reviewers.
Instructions
Purpose: Store a structured handoff packet for the next agent or human reviewer. When to use: call when pausing, finishing, or transferring a task. Inputs: workspace_id, from/to agents, summary, next steps, blockers, tested commands, remaining risks, next action, and template. Side effects: writes a handoff row. Output: handoff_id for future retrieval. Failure modes: invalid workspace or malformed list fields are rejected.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | Handoff status such as open, closed, or blocked. | open |
| summary | Yes | Concise summary of completed work and current state. | |
| template | No | Handoff template name, usually standard. | standard |
| blocked_on | No | Optional blockers that prevent progress. | |
| next_steps | No | Optional ordered next steps for the receiver. | |
| next_action | No | Single most important next action. | |
| workspace_id | Yes | Workspace UUID where the handoff belongs. | |
| to_agent_name | No | Optional intended receiving agent or role. | |
| from_agent_name | Yes | Agent that is leaving the handoff. | |
| remaining_risks | No | Known risks, caveats, or areas needing follow-up. | |
| tested_commands | No | Commands already run to validate the work. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||