| name | specrew-review |
| description | Run live continuous co-review or replay persisted reviewer evidence for an iteration. |
specrew-review
Type: Operational Skill
Schema: v1
Status: Active
Namespace: /specrew
Canonical command: /specrew-review
Purpose
Trigger or inspect the Specrew review-oriented workflow. Use live mode to run the continuous co-review runtime and persist reviewer evidence under .specrew/review/inline/<run-id>/; use replay mode to inspect an existing reviewer closeout packet for a completed iteration.
When to Use
- When a reviewer needs a live continuous co-review run before or during a review boundary.
- When a reviewer wants to inspect the review summary for a completed iteration.
- When replaying the reviewer closeout packet.
- Invoke this skill when the user says: "Run the reviewer", "Run live review", "Show the review summary", "Review the iteration", "Show reviewer output".
Boundary Safety
This skill supports review work but does not bypass the required human decision point. A human reviewer must still explicitly approve lifecycle advancement. Invoking /specrew-review is not equivalent to approving an iteration for closure or advancement.
Feature 016 rule: Humans remain the approval authority for major boundary transitions. This command may not imply authorization to advance from any lifecycle boundary.
Coexistence Contract
This skill is part of the /specrew-* command surface. It coexists with /speckit.* review-related commands without collision or shadow. Using /specrew-review does not substitute for /speckit.* lifecycle actions that require explicit human authorization.
Invocation
/specrew-review [<iteration>] [--project-path <path>] [--feature <id>]
[--iteration <NNN>] [--quiet] [--json] [--open]
/specrew-review --live [--baseline-ref <git-ref>] [--project-path <path>] # baseline auto-anchors for signoff; an explicit --baseline-ref run is exploratory-only
[--checkpoint-id <id>] [--run-id <id>] [--host <host>]
[--model <model>] [--effort <effort>] [--authorization-ref <ref>]
[--code-writer-host <host>]
[--design-context-ref <path>] [--allowed-path <path>]
[--forbidden-path <path>] [--exclude-path <path>]
[--reviewer-config <path>] [--schema-root <path>]
[--run-root <path>] [--timeout-seconds <N>]
[--fallback-policy <none|one-authorized-availability-fallback>]
[--preserve-debug]
Backed by: specrew review / scripts/specrew-review.ps1
Inputs
| Input | Type | Required | Description |
|---|
<iteration> | string (positional) | No | Iteration number to replay (defaults to most recent closed iteration) |
--project-path | string | No | Target Specrew project path (defaults to current directory) |
--feature | string | No | Restrict lookup to one feature directory under specs\ |
--iteration | string | No | Replay a specific iteration directory |
--quiet | flag | No | Emit only the stable machine-parseable digest line |
--json | flag | No | Emit JSON summary instead of the visual reviewer summary |
--open | flag | No | Open reviewer-index.md and review-diagrams.md when present |
--live | flag | No | Run the continuous co-review runtime instead of replaying prior closeout state |
--baseline-ref | string | Yes for --live | Git ref used to compute the review change set |
--checkpoint-id | string | No | Stable checkpoint identifier for the live review request |
--run-id | string | No | Explicit run id for evidence under .specrew/review/inline/<run-id>/ |
--host | string | No | Reviewer host to request (claude, codex, copilot, cursor-agent, or antigravity) |
--model | string | No | Reviewer model override; non-default models require --authorization-ref |
--effort | string | No | Optional host-specific reviewer reasoning/effort label persisted in evidence |
--authorization-ref | string | No | Human authorization reference for host/model selection |
--code-writer-host | string | No | Implementation host (claude, codex, etc.) used to prefer an independent peer reviewer |
--design-context-ref | string | No | Design or lifecycle artifact to include in the review request context |
--allowed-path | string | No | Add a mutable path allowlist entry for this live review run |
--forbidden-path | string | No | Add a protected path entry for this live review run |
--exclude-path | string | No | Add a change-set exclusion entry for this live review run |
--reviewer-config | string | No | JSON reviewer host configuration for deterministic or authorized hosts |
--schema-root | string | No | Contract schema root for ReviewRequest and FindingsResult validation |
--run-root | string | No | Override the evidence output root; defaults to .specrew/review/inline |
--timeout-seconds | number | No | Live reviewer host timeout |
--fallback-policy | string | No | Host fallback policy (none or one-authorized-availability-fallback) |
--preserve-debug | flag | No | Preserve debug artifacts from the live review run |
Outputs
- Live
ReviewRequest, prompt bundle, host invocation metadata, FindingsResult, gate verdict, and run index under .specrew/review/inline/<run-id>/ when --live is used.
- Reviewer closeout packet for the specified iteration when replay mode is used.
- Raw/native output from the underlying
specrew review workflow with minimal wrapper context.
Argument Whitelist
Only the arguments listed above are accepted in v1. Unknown arguments are rejected with command-specific help guidance.
Failure Guidance
| Failure mode | Behavior |
|---|
| Unsupported argument | Rejected immediately with command-specific help guidance |
Missing --baseline-ref in live mode | Error explaining that live review needs a baseline ref |
| Unauthorized reviewer host/model | Infrastructure failure with reviewer authorization guidance; do not treat this as reviewer approval |
| No iteration found | Error with guidance to check specs/ directory structure |
| Missing project setup | Stop with specrew init remediation |
See Also
/specrew-where — current project status (live, not review replay)/specrew-help — catalog fallback and full command list
