---
title: review
description: Review the current repository state with configured agents.
---

`review` runs the shared `Review` component over the prompt and returns structured reviewer feedback, approval status, and issues.

```bash
bunx smithers-orchestrator 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="/images/workflow-ui/review.png" alt="review workflow UI showing per-reviewer approval verdicts and structured issues" />
</Frame>

## Inputs

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

## Output Shape

Reviewers return:

- `reviewer`: identifier string for the agent 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`.
