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

# Review and rework

> How Iron Octopus reviews every change, sends issues back, and decides when a person should look.

Every work item is reviewed before it counts as done. The review is matched to the risk of the change: the riskier it is, the higher the bar it has to clear, and the more likely a person sees it.

## What review decides

Each review ends in one of three outcomes:

| Outcome | What happens next |
| - | - |
| Approved | The work item is done. |
| Rework required | The issues go back to be fixed, and the work item is reviewed again. |
| Human review required | The work item waits for a person to review it. It shows under **Needs you** on Home as **Review requested**. |

## Risk levels

Each work item has a risk level when it's planned: **Low**, **Standard**, **High** or **Critical**. The risk level sets two things.

**How sure the review has to be.** Iron Octopus approves a change on its own only when the review is confident enough for its risk level. Below that, a person reviews it.

| Risk | Approved by Iron Octopus when confidence is at least | Rework rounds before a person reviews |
| - | - | - |
| Low | 95% | 2 |
| Standard | 97% | 3 |
| High | 99% | 4 |
| Critical | Always reviewed by a person | 4 |

**How many times it can go back.** If a work item still has issues after its rework rounds, it goes to a person instead of looping.

A person also reviews any acceptance criterion Iron Octopus can't verify, can't check yet, or judges not to apply.

> [!NOTE]
>
> These are the default rules. You can change the thresholds and limits for one project or your whole workspace. 

## Caught in review

Home has a **Caught in review** section listing what review found and sent back in the last 14 days: the issue, the feature and work item, its risk level, and the attempt it was approved on. Below it, a line totals review all time: how many changes were approved, sent back for rework, and sent to a person.

It's the plainest record of Iron Octopus checking its own work.

## Review a change yourself

When a work item needs you, open it from **Needs you**, read the change and what review found, and click **Submit review** with your decision.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.