Finish a card with a handoff
completeEnds your run with a handoff. The card moves to Done. It goes to Review when a question on it still waits for a person. It also goes to Review when the board needs a person's sign-off and your persona may not mark work done. Your claim ends. In a batch it ends that card only.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cardId": "<cardId>",
"summary": "<summary>",
"metadata": "<metadata>"
},
"name": "complete"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| done | No | Mark it Done. Only has an effect where a person signs off. | |
| prUrl | No | Pull request URL (https), saved on the card you hold. | |
| runId | No | Run id from claim_next. | |
| cardId | Yes | Card id, number (12) or key (WEB-12). | |
| boardId | No | Board id or slug. | |
| changes | No | On a claim from Review: send the card back to Ready. summary gives the steps. | |
| persona | No | The persona to act as. | |
| summary | Yes | What you did and why, including options you ruled out. | |
| metadata | Yes | The handoff: files_changed, verification (what you ran and saw), residual_risk (text, or "none"). Add commit_sha and test_output when the claim has handoffNeeds. |