> ## Documentation Index
> Fetch the complete documentation index at: https://smithers.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# review

> Review the current repository state with configured agents.

`review` is an archived example, not installed by `init`: copy it from `examples/init-pack/` with its dependency closure, or ask `create-workflow` to build an equivalent. It runs the shared `Review` component over the prompt and returns structured reviewer feedback, approval status, and issues.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
bunx smthrs workflow run review --prompt "Review the current repository changes"
```

<Frame caption="The review UI shows each reviewer's verdict and issues by severity, plus the moderator's synthesized approval status.">
  <img src="https://mintcdn.com/smithers/py7ertgBTLCgQQDl/images/workflow-ui/review.png?fit=max&auto=format&n=py7ertgBTLCgQQDl&q=85&s=6740081539f9bd4d87bd7b71614446cc" alt="review workflow UI showing per-reviewer approval verdicts and structured issues" width="1280" height="832" data-path="images/workflow-ui/review.png" />
</Frame>

## Inputs

| Input    | Type   | Default                                    |
| -------- | ------ | ------------------------------------------ |
| `prompt` | string | `"Review the current repository changes."` |

## Output Shape

Reviewers return:

* `reviewer`: agent id that produced this review (e.g. `reviewer-1`).
* `approved`: whether the change is production-ready.
* `feedback`: concise review notes.
* `issues`: structured findings with severity, title, optional file, and description.

## Use it when

* You want structured reviewer feedback and an approval verdict on the current repo state.
* After manual edits, [`implement`](/workflows/implement), [`mission`](/workflows/mission), or [`kanban`](/workflows/kanban).

## Use something else when

* You want the fix applied, not just reviewed: use [`implement`](/workflows/implement) or [`debug`](/workflows/debug).
* You want a feature-by-feature gap review: use [`audit`](/workflows/audit).

## Resume & retry

`review` is read-only and returns reviewer findings in the run output. Runs are durable and resume with `up --resume`.