patch_story
Atomically edit a story's plan-authored fields in the manifest without hand-editing JSON, avoiding write races with the scheduler's advance tick.
Instructions
Edit a story's plan-authored fields (agent_instructions, model, persona,
risk, dependencies, acceptance, pr_url, summary, tdd_split, backend,
blocked_by: a list of ":<story_key>" strings) without hand-editing
the manifest JSON. files is not patchable: use ingest_plan to re-ingest.
Hand-editing the manifest races the scheduler's 60s advance_all_plans tick - a read-modify-write on either side can clobber the other's write. This tool takes the same _plan_lock the scheduler and dispatch_story use, so the edit is atomic with respect to it. Only the fields above may be set; status transitions go through set_story_status, not this tool.
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": {
"plan_name": "<plan_name>",
"story_key": "<story_key>",
"fields": "<fields>"
},
"name": "patch_story"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fields | Yes | ||
| plan_name | Yes | ||
| story_key | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||