> ## 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.

<img src="https://mintcdn.com/adaline/o8h3k4eQQbaIV193/images/platform-v2/improve/cycle-review-top.png?fit=max&auto=format&n=o8h3k4eQQbaIV193&q=85&s=4e2effcdac95f3c72c646116ca578ee7" alt="Improve review page showing diagnosis, representative failing traces, prompt diff, and traffic comparison" title="Review an Improve candidate" style={{ width: "100%" }} width="3350" height="1712" data-path="images/platform-v2/improve/cycle-review-top.png" />

## 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.

<img src="https://mintcdn.com/adaline/o8h3k4eQQbaIV193/images/platform-v2/improve/cycle-stage-provenance.png?fit=max&auto=format&n=o8h3k4eQQbaIV193&q=85&s=b3e771df59c8992cebecba68f080df34" alt="Improve cycle stage provenance showing Behaviors, Evals, Datasets, Prompts, and Review evidence" title="Improve stage provenance" style={{ width: "100%" }} width="1318" height="324" data-path="images/platform-v2/improve/cycle-stage-provenance.png" />

| 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.

<img src="https://mintcdn.com/adaline/o8h3k4eQQbaIV193/images/platform-v2/improve/traffic-comparison.png?fit=max&auto=format&n=o8h3k4eQQbaIV193&q=85&s=222b763aa3d8e803bd21da8614121d38" alt="Candidate review traffic comparison showing current and improved outputs for tested conversations" title="Candidate traffic comparison" style={{ width: "100%" }} width="1310" height="784" data-path="images/platform-v2/improve/traffic-comparison.png" />

| 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.                             |

<img src="https://mintcdn.com/adaline/o8h3k4eQQbaIV193/images/platform-v2/improve/review-regression-runtime.png?fit=max&auto=format&n=o8h3k4eQQbaIV193&q=85&s=26c103009dc205f9955b35784e10790a" alt="Improve regression report and runtime tradeoff section showing evaluator scores, cost, latency, and token movement" title="Regression and runtime evidence" style={{ width: "100%" }} width="1318" height="1024" data-path="images/platform-v2/improve/review-regression-runtime.png" />

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.
</Warning>

## After the decision

<img src="https://mintcdn.com/adaline/o8h3k4eQQbaIV193/images/platform-v2/improve/review-ready-actions.png?fit=max&auto=format&n=o8h3k4eQQbaIV193&q=85&s=2af1ec5be4d74b288375b4bc98a9af4d" alt="Improve review action bar showing no regressions, target prompt, cycle number, version creation, reject, and edit and approve actions" title="Review-ready actions" style={{ width: "100%" }} width="1326" height="147" data-path="images/platform-v2/improve/review-ready-actions.png" />

| Decision           | What to do next                                                                                                                                                                                                               |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Approve**        | Apply the selected candidate and deploy it when a primary environment is configured. Watch [Monitor](/monitor/overview), [Logs](/monitor/analyze-log-traces), and [Behaviors](/behaviors/overview) during the release window. |
| **Edit & approve** | Apply the candidate, inspect or adjust the prompt, run evaluations, then release through [Deploy your prompt](/deploy/deploy-your-prompt) 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.

<CardGroup cols={2}>
  <Card title="Export Audit Packet" icon="download" href="/improve/export-audit-packet">
    Download the review evidence as JSON for records or external systems.
  </Card>

  <Card title="Auto Prompt Optimization" icon="wand-sparkles" href="/improve/prompt-optimization">
    Understand candidate exploration, safety gates, and scoring evidence.
  </Card>

  <Card title="Auto Generated Evaluators" icon="flask-conical" href="/improve/auto-generated-evaluators">
    See how generated evaluators help check the candidate before release.
  </Card>

  <Card title="Deploy your prompt" icon="rocket" href="/deploy/deploy-your-prompt">
    Continue from reviewed prompt version to deployment.
  </Card>
</CardGroup>
