review_story
Runs a code review on a dispatched story's tests-passed branch; on approval, opens a pull request and sets status to pr_open, otherwise records changes_requested. Never merges.
Instructions
Run the code-reviewer persona over a dispatched story's branch. On APPROVE, open a PR via gh and set status to pr_open; otherwise set status to changes_requested. Does not merge — merge is the overlord's decision.
Only reviewable when story["status"] == "tests_passed" - any other status (a stale/duplicate call, e.g. a second tick racing an already-merged story) is a no-op skip; see README.md's "Review & merge" section.
force (default false) is the explicit, audited way to re-run a review the unchanged-since-last-review skip would otherwise decline: it clears the story's last-reviewed markers (last_reviewed_sha, the reviewing-logic fingerprint and skip_notified_sha) so the review actually runs, and records one story:force_review audit entry. The first review after a force has no last_reviewed_sha and is therefore a first-style full-branch review of HEAD, not a since_sha rework diff. It refuses (changing nothing) while a detached review job holds the story, and for any status but tests_passed; it never merges anything, and it leaves review_verdict, review_feedback and the rework budget alone, so a forced review counts against that budget like any other.
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>"
},
"name": "review_story"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | ||
| plan_name | Yes | ||
| story_key | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||