---
title: Guides
description: Real scenarios — parallel issues, CI recovery, review loops, multi-project setups.
---

These guides are task-shaped: each one covers a single thing you'd actually want AO to do for you, end to end.

<Cards>
  <Card title="Per-role agents" description="Run a reasoning-heavy orchestrator and a fast worker — globally or per-project." href="/docs/guides/per-role-agents" />
  <Card title="Parallel issues" description="Spawn agents on several issues at once without them stepping on each other." href="/docs/guides/parallel-issues" />
  <Card title="CI recovery" description="How AO notices red CI and nudges the agent to fix it without you babysitting." href="/docs/guides/ci-recovery" />
  <Card title="Review loop" description="When a reviewer asks for changes, AO replays the feedback to the agent." href="/docs/guides/review-loop" />
  <Card title="Reaction recipes" description="Watch-only mode, auto-merge opt-in, custom CI messages, bot handling." href="/docs/guides/reactions" />
  <Card title="Multi-project" description="Run AO against several repos from one dashboard." href="/docs/guides/multi-project" />
</Cards>
