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