For AI agents: the complete documentation index is available at https://docs.flezise.com/llms.txt, the full documentation bundle is available at https://docs.flezise.com/llms-full.txt, and this page is available as Markdown at https://docs.flezise.com/artifacts/review-findings.md.
Docs

Review findings

After an artifact is submitted for review, the verifier agent runs and posts its findings. Approving is blocked until every finding and embedded marker is resolved. The Review cockpit is where that work happens.

Note

A review cockpit shot is needed here. Proposed id: review-cockpit. What it shows: the Review modal open on an artifact in review, with the left-hand item list and a finding detail panel on the right.

Open the Review cockpit

Press the Review button pinned at the bottom of the right-hand sidebar. The badge on the button shows the count of outstanding items. The cockpit opens as a modal with a two-column layout: a guided item list on the left and the active item's detail on the right.

The Review readiness card at the top of the sidebar summarizes the state before you open the cockpit: it counts Argus findings, Assumptions, and Verification items still outstanding.

Review overview

The first item in the queue is always the Review overview. It shows the verifier agent's overall assessment: a score out of 100 and a verdict of either "Passed" or "Needs attention". Read it first to understand the scope before working through the issues below.

Argus findings

Each finding has a severity: critical, high, medium, low, or info. For each finding you can:

  • Queue repair guidance (labeled as "steer") to tell the builder agent how to fix the issue.
  • Queue a waiver to acknowledge the finding without a content change.

Both actions are staged. When you are done queuing actions across all findings, the cockpit applies them in a single batch. The batch is locked to the current content hash; if the content has changed since you loaded the findings, the drafts are invalidated and you must re-queue.

Decision markers

The verifier agent embeds inline markers in the artifact content for claims that need human judgment: assumptions that need verification, and statements that need a decision. These appear as items of kind "marker" in the cockpit queue and block approval until resolved.

For each marker, choose one outcome:

  • Confirm current statement: the text stands as written.
  • Replace marked statement: provide the exact replacement text, then press Apply decision.

Applying a decision while the artifact is In Review moves it to Revise so the builder agent can incorporate the change. The author then resubmits.

Filters

Use the filter tabs at the top of the item list to focus on a subset:

FilterShows
AllEvery item in the queue
BlockingFindings and markers that must be resolved before approval
FindingsArgus findings only
ChangedSections that differ from the last approved version
CommentsInline comment threads

Navigate between items with the arrow buttons in the footer of each detail panel, or click a row in the list directly.

Next steps