Tutorial: review pipeline

Goal: scan changed files, run parallel review agents, synthesize a report — using the real review workflow shape.

Prerequisites

• Carina installed (carina doctor green)
• Daemon running
• A git repository with a non-trivial working-tree diff

1. Install the workflow

Copy or symlink the example:

mkdir -p .carina/workflows
cp examples/workflows/review.json .carina/workflows/review.json

Or author your own using the shape in Workflows overview.

2. Run it

run-workflow.sh

carina workflow run review
# optional focus string
carina workflow run review "focus on auth and session handling"

This creates a safe-edit session in cwd by default and waits for completion.

3. Watch status

carina workflow status RUN_ID
carina workflow list

Live progress reports completed/failed/skipped/total counters.

4. Inspect audit

audit.sh

# use the session id from the run
carina audit SESSION_ID
carina audit verify SESSION_ID

Each step is an attenuated subagent; side effects still pass the kernel.

5. Streaming variant (optional)

For larger graphs or uneven step times, switch to streaming mode (see examples/workflows/swarm-review.json) and set "execution_mode": "streaming".

6. Control

control.sh

carina workflow pause RUN_ID
carina workflow resume RUN_ID
carina workflow stop RUN_ID

Tip

For write-gated pipelines, insert a human approval step or run reviewers under read-only profiles so synthesis cannot mutate the tree without an explicit follow-up.

Source of truth

• Example: examples/workflows/review.json · streaming: examples/workflows/swarm-review.json
• Concepts: Workflows overview · docs/workflows.md
• CLI: carina workflow … · audit: carina audit / carina audit verify

Next

• Sub-agents — attenuation model for each step
• Audit — verify after the run