// Review a spec, plan, design, decomposition, architecture doc, pre-mortem, runbook, or acceptance report with metareview.
Run metareview post-merge learning after a PR or local merge completes; curates reusable review knowledge, records discarded low-value candidates, and appends reviewer calibration.
Run metareview's deterministic epic-ready gate before closing or landing an epic; checks child review evidence, unresolved blockers, integration contradictions, and intent drift.
Run metareview's deterministic PR-ready gate before pushing or opening a PR; checks unresolved blockers, validation evidence, branch diff risks, generated PR evidence, and optional GitHub review context.
Run metareview's deterministic task-done code review gate before claiming a local task is complete; use for task closure, chunk review, or pre-PR local review when code changed.
Detect repository mode and prepare metareview review artifacts without overwriting metaswarm or Beads-owned files.
Show metareview repository mode, available integrations, and unresolved review state.
| name | review-artifact |
| description | Review a spec, plan, design, decomposition, architecture doc, pre-mortem, runbook, or acceptance report with metareview. |
Use when reviewing a Markdown artifact before implementation or before a gate is considered passed.
metareview review artifact <path> to create the review scaffold. The command exits nonzero while the review is still NOT_REVIEWED; this is expected and is blocking.rubrics/artifact-review-rubric.md.in-session-emulated when subagents are unavailable or the human explicitly requests no delegation. If falling back, state that the review is not independently adversarial and treat it as weaker evidence.NEEDS_REVISION and ESCALATE are valid review results when supported by findings.metareview review artifact <path> --previous-run <run-id> so the new run links to the prior attempt.Use metareview review artifact <path> --scaffold-only only when explicitly creating a scaffold without claiming the review is complete.
A review execution is incomplete while required reviewer rows are missing, any reviewer lacks a verdict, or the aggregate verdict is NOT_REVIEWED. Do not call an artifact implementation-ready while the verdict is ESCALATE or NEEDS_REVISION, required reviewer rows are missing, reviewer verdicts are missing, or blocking findings remain unresolved unless the human explicitly accepts the risk.