Marcos Paulo
89 lines
2.9 KiB
HTML
89 lines
2.9 KiB
HTML
<!doctype html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
<meta name="viewport" content="width=device-width,initial-scale=1" />
|
|
<title>AI For Dummies — Agents and trees</title>
|
|
<link rel="stylesheet" href="../chapters.css" />
|
|
</head>
|
|
<body>
|
|
<main>
|
|
<header class="top">
|
|
<a href="../summary/">← ROUTE MAP</a><span>02 / AGENTS & TREES</span
|
|
><a href="../full-guide/">field guide ↗</a>
|
|
</header>
|
|
<section class="hero">
|
|
<p class="eyebrow">Subagent workflow</p>
|
|
<h1>One branch<br />per <em>hand.</em></h1>
|
|
<p>
|
|
Agents work when roles, files, and evidence are bounded. A worktree gives each worker its
|
|
own checkout while the orchestrator protects intent.
|
|
</p>
|
|
</section>
|
|
<section class="pipeline">
|
|
<div>
|
|
<p class="eyebrow">The tree</p>
|
|
<h2>Split at<br />the <em>seam.</em></h2>
|
|
</div>
|
|
<div class="panel">
|
|
<strong>MAIN / ORCHESTRATOR</strong
|
|
><code
|
|
>├── agent/ui → components + visual states · ├── agent/tests → acceptance + regressions
|
|
· └── agent/docs → guide + examples · merge after each leaf returns a diff and
|
|
evidence</code
|
|
>
|
|
</div>
|
|
</section>
|
|
<section class="grid">
|
|
<article class="card">
|
|
<b>FRAME</b>
|
|
<h2>Orchestrator</h2>
|
|
<p>Owns scope, task graph, boundaries, and integration.</p>
|
|
</article>
|
|
<article class="card">
|
|
<b>HAND OFF</b>
|
|
<h2>Worker</h2>
|
|
<p>Owns one coherent slice and one worktree.</p>
|
|
</article>
|
|
<article class="card">
|
|
<b>PROVE</b>
|
|
<h2>Verifier</h2>
|
|
<p>Re-runs gates and reports remaining gaps.</p>
|
|
</article>
|
|
</section>
|
|
<section class="practice">
|
|
<div>
|
|
<p class="eyebrow">Handoff</p>
|
|
<h2>Context that<br />can <em>travel.</em></h2>
|
|
</div>
|
|
<div class="steps">
|
|
<article>
|
|
<b>01</b>
|
|
<div>
|
|
<strong>Brief</strong
|
|
><span>Goal, owned files, dependencies, non-goals, acceptance.</span>
|
|
</div>
|
|
</article>
|
|
<article>
|
|
<b>02</b>
|
|
<div>
|
|
<strong>Isolation</strong><span>One branch and worktree per independent change.</span>
|
|
</div>
|
|
</article>
|
|
<article>
|
|
<b>03</b>
|
|
<div>
|
|
<strong>Evidence</strong
|
|
><span>Commands, result, changed files, screenshots, gaps.</span>
|
|
</div>
|
|
</article>
|
|
</div>
|
|
</section>
|
|
<nav class="links">
|
|
<a href="../models/">Previous: models →</a><a href="../rules/">Rules case study →</a
|
|
><a href="../hands-on/rules/">Try the rules lab →</a>
|
|
</nav>
|
|
</main>
|
|
</body>
|
|
</html>
|