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

# Review a Cycle

> Review diagnosis, candidate outputs, evaluator movement, traffic examples, and deployment impact before approving

Every completed Improve cycle pauses for human or external AI review. Use the review page to decide whether Adaline's candidate should be approved, edited, or rejected.

The reviewer, whether a person or external AI agent, owns the production decision: the diagnosis must match the real issue, the diff must be understandable, impact must be acceptable, and the deployment target must be correct.

![Improve review page showing diagnosis, representative failing traces, prompt diff, and traffic comparison](https://mintcdn.com/adaline/o8h3k4eQQbaIV193/images/platform-v2/improve/cycle-review-top.png?fit=max\&auto=format\&n=o8h3k4eQQbaIV193\&q=85\&s=4e2effcdac95f3c72c646116ca578ee7)

## Read the review page top to bottom

Start with the evidence path. A good review package shows how the cycle moved from production evidence to candidate prompt changes, and whether each stage produced enough signal to support a release decision.

![Improve cycle stage provenance showing Behaviors, Evals, Datasets, Prompts, and Review evidence](https://mintcdn.com/adaline/o8h3k4eQQbaIV193/images/platform-v2/improve/cycle-stage-provenance.png?fit=max\&auto=format\&n=o8h3k4eQQbaIV193\&q=85\&s=b3e771df59c8992cebecba68f080df34)

| Stage | What to check |
| - | - |
| **Behaviors** | The run targeted a specific repeated pattern or issue. |
| **Evals** | Authored and auto generated evaluators cover the target behavior and important healthy paths. |
| **Datasets** | Production, curated, and synthetic cases are representative enough to compare baseline and candidate. |
| **Prompts** | Multiple candidates were explored, and unsafe or regressing options were filtered out. |
| **Review** | The selected candidate has a diff, traffic examples, score movement, and runtime tradeoffs. |

Then move through the candidate review itself. Read the diagnosis first, confirm the selected candidate, inspect the diff, compare example outputs, check regressions, and only then look at deployment impact.

![Candidate review traffic comparison showing current and improved outputs for tested conversations](https://mintcdn.com/adaline/o8h3k4eQQbaIV193/images/platform-v2/improve/traffic-comparison.png?fit=max\&auto=format\&n=o8h3k4eQQbaIV193\&q=85\&s=222b763aa3d8e803bd21da8614121d38)

| Section | Question | Stop if |
| - | - | - |
| **Diagnosis** | What problem did Adaline try to fix? | It does not match the customer or product issue. |
| **Candidate** | Which candidate is selected? | It is not the candidate you intend to apply. |
| **Prompt diff** | What exactly changes? | The diff changes policy, format, tool behavior, or tone in a risky way. |
| **Traffic comparison** | Would real users get a better answer? | Scores improved but the user experience got worse. |
| **Regression report** | Which checks improved or regressed? | A protected evaluator drops without explicit signoff. |
| **Cost, tokens, latency** | What runtime tradeoff comes with the candidate? | The movement breaks the release budget. |
| **Deployment target** | Which environment changes if approved? | The target environment is wrong or unclear. |

![Improve regression report and runtime tradeoff section showing evaluator scores, cost, latency, and token movement](https://mintcdn.com/adaline/o8h3k4eQQbaIV193/images/platform-v2/improve/review-regression-runtime.png?fit=max\&auto=format\&n=o8h3k4eQQbaIV193\&q=85\&s=26c103009dc205f9955b35784e10790a)

Before approving, make sure the diagnosis matches the customer or product problem, the supporting Behaviors and logs are relevant, the prompt diff is understandable, evaluator or dataset regressions are acceptable, runtime impact is acceptable, and the deployment target is the one you intend to change.

> [!WARNING]
>
> Approve can affect production when the project has a deployment environment. Use **Edit & approve** when you want to inspect or adjust the prompt before deployment.

## After the decision

![Improve review action bar showing no regressions, target prompt, cycle number, version creation, reject, and edit and approve actions](https://mintcdn.com/adaline/o8h3k4eQQbaIV193/images/platform-v2/improve/review-ready-actions.png?fit=max\&auto=format\&n=o8h3k4eQQbaIV193\&q=85\&s=2af1ec5be4d74b288375b4bc98a9af4d)

| Decision | What to do next |
| - | - |
| **Approve** | Apply the selected candidate and deploy it when a primary environment is configured. Watch [Monitor](https://www.adaline.ai/docs/monitor/overview.md), [Logs](https://www.adaline.ai/docs/monitor/analyze-log-traces.md), and [Behaviors](https://www.adaline.ai/docs/behaviors/overview.md) during the release window. |
| **Edit & approve** | Apply the candidate, inspect or adjust the prompt, run evaluations, then release through [Deploy your prompt](https://www.adaline.ai/docs/deploy/deploy-your-prompt.md) or your external deployment path. |
| **Reject** | Leave the prompt unchanged and record the reason: wrong diagnosis, weak evidence, regression, runtime cost, or wrong fix layer. |

You can also export the audit packet as JSON for records, external AI review, or a no-human-in-the-loop handoff before deciding what happens next.

> [card] [Export Audit Packet](https://www.adaline.ai/docs/improve/export-audit-packet.md)
>
> Download the review evidence as JSON for records or external systems.

> [card] [Auto Prompt Optimization](https://www.adaline.ai/docs/improve/prompt-optimization.md)
>
> Understand candidate exploration, safety gates, and scoring evidence.

> [card] [Auto Generated Evaluators](https://www.adaline.ai/docs/improve/auto-generated-evaluators.md)
>
> See how generated evaluators help check the candidate before release.

> [card] [Deploy your prompt](https://www.adaline.ai/docs/deploy/deploy-your-prompt.md)
>
> Continue from reviewed prompt version to deployment.


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