Marcos Paulo
2cda37b553
Built from main 79920c9e6c
feat: give the chapters motion, diagrams, and retrieval practice
8 lines
6.8 KiB
HTML
8 lines
6.8 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><meta name="description" content="Agents work when roles, files, and evidence are bounded. A worktree gives each worker its own checkout while the orchestrator protects intent."><link rel="stylesheet" href="/ai-for-dummies/_astro/tokens.BxNFvepo.css"><link rel="stylesheet" href="/ai-for-dummies/fonts/fonts.css"><link rel="stylesheet" href="/ai-for-dummies/_astro/base.BX9jSTkZ.css"><link rel="stylesheet" href="/ai-for-dummies/_astro/chapters.BPlnnXOa.css"><link rel="stylesheet" href="/ai-for-dummies/_astro/motion.DuPi8tKA.css"><link rel="stylesheet" href="/ai-for-dummies/_astro/agents.TiH4HiC7.css">
|
|
<link rel="stylesheet" href="/ai-for-dummies/_astro/ChapterHero.DU6N_2z3.css">
|
|
<link rel="stylesheet" href="/ai-for-dummies/_astro/StepFlow.D8D5Or_Q.css">
|
|
<link rel="stylesheet" href="/ai-for-dummies/_astro/WorktreeMap.Dwo7bA_e.css"></head> <body> <header class="top" id="top" data-astro-cid-xattfbdu> <div class="cell" data-astro-cid-xattfbdu><a href="/ai-for-dummies/summary/" data-astro-cid-lxoypzh2>← ROUTE MAP</a></div> <div class="cell" data-astro-cid-xattfbdu><span data-astro-cid-lxoypzh2>02 / AGENTS & TREES</span></div> <div class="cell" data-astro-cid-xattfbdu><a href="/ai-for-dummies/full-guide/" data-astro-cid-lxoypzh2>field guide ↗</a></div> </header> <main> <section class="hero rise-in" data-astro-cid-7xzskqga> <p data-astro-cid-4yr5atew="true" class="eyebrow tone-red">Subagent workflow</p> <h1 class="parallax-near" data-astro-cid-7xzskqga><span data-astro-cid-lxoypzh2>One branch<br>per <em>hand.</em></span></h1> <div class="intro parallax-far" data-astro-cid-7xzskqga> <p data-astro-cid-lxoypzh2>Agents work when roles, files, and evidence are bounded. A worktree gives each worker its own checkout while the orchestrator protects intent.</p> </div> </section> <section class="pipeline reveal" data-astro-cid-lxoypzh2> <div class="depth-slow" data-astro-cid-lxoypzh2> <p class="eyebrow" data-astro-cid-lxoypzh2>The tree</p> <h2 data-astro-cid-lxoypzh2>Split at<br>the <em>seam.</em></h2> <svg class="draw-line" viewBox="0 0 110 110" aria-hidden="true" focusable="false" style="--draw-height: 110px" data-astro-cid-n6ozym62> <path d="M 0.5 0 V 86.5 Q 0.5 109.5 24 109.5 H 110" pathLength="100" data-astro-cid-n6ozym62></path> </svg> </div> <div class="panel depth-fast" data-astro-cid-lxoypzh2> <strong data-astro-cid-lxoypzh2>MAIN / ORCHESTRATOR</strong> <code data-astro-cid-lxoypzh2>├── agent/ui → components + visual states
|
|
├── agent/tests → acceptance + regressions
|
|
└── agent/docs → guide + examples
|
|
|
|
merge after each leaf returns a diff and evidence</code> </div> <div class="tree-figure" data-astro-cid-lxoypzh2> <div class="tree-stage is-static" data-astro-cid-lsutp3lb> <svg viewBox="0 0 760 330" preserveAspectRatio="none" aria-hidden="true" data-astro-cid-lsutp3lb> <path class="tree-edge trunk" d="M380 48 V118" data-astro-cid-lsutp3lb></path> <path class="tree-edge" d="M380 118 C380 170 110 150 110 224" data-astro-cid-lsutp3lb></path> <path class="tree-edge" d="M380 118 V224" data-astro-cid-lsutp3lb></path> <path class="tree-edge" d="M380 118 C380 170 650 150 650 224" data-astro-cid-lsutp3lb></path> </svg> <div data-astro-cid-lsutp3lb="true" class="tree-node root active"> <span data-astro-cid-lsutp3lb> Orchestrator </span> <strong data-astro-cid-lsutp3lb>main</strong> <small data-astro-cid-lsutp3lb> ● clean </small> </div> <div data-astro-cid-lsutp3lb="true" class="tree-node branch ui"> <span data-astro-cid-lsutp3lb> UI worker </span> <strong data-astro-cid-lsutp3lb>agent/ui</strong> <small data-astro-cid-lsutp3lb> ● working </small> </div><div data-astro-cid-lsutp3lb="true" class="tree-node branch tests"> <span data-astro-cid-lsutp3lb> Test worker </span> <strong data-astro-cid-lsutp3lb>agent/tests</strong> <small data-astro-cid-lsutp3lb> ● ready </small> </div><div data-astro-cid-lsutp3lb="true" class="tree-node branch docs"> <span data-astro-cid-lsutp3lb> Docs worker </span> <strong data-astro-cid-lsutp3lb>agent/docs</strong> <small data-astro-cid-lsutp3lb> ● review </small> </div> </div> </div> </section> <section class="grid reveal" data-astro-cid-lxoypzh2> <article class="card" data-astro-cid-lxoypzh2> <b data-astro-cid-lxoypzh2>FRAME</b> <h2 data-astro-cid-lxoypzh2>Orchestrator</h2> <p data-astro-cid-lxoypzh2>Owns scope, task graph, boundaries, and integration.</p> </article><article class="card" data-astro-cid-lxoypzh2> <b data-astro-cid-lxoypzh2>HAND OFF</b> <h2 data-astro-cid-lxoypzh2>Worker</h2> <p data-astro-cid-lxoypzh2>Owns one coherent slice and one worktree.</p> </article><article class="card" data-astro-cid-lxoypzh2> <b data-astro-cid-lxoypzh2>PROVE</b> <h2 data-astro-cid-lxoypzh2>Verifier</h2> <p data-astro-cid-lxoypzh2>Re-runs gates and reports remaining gaps.</p> </article> </section> <section class="practice reveal" data-astro-cid-lxoypzh2> <div class="depth-slow" data-astro-cid-lxoypzh2> <p class="eyebrow" data-astro-cid-lxoypzh2>Handoff</p> <h2 data-astro-cid-lxoypzh2>Context that<br>can <em>travel.</em></h2> <svg class="draw-line" viewBox="0 0 4 110" aria-hidden="true" focusable="false" style="--draw-height: 110px" data-astro-cid-n6ozym62> <path d="M 0.5 0 V 110" pathLength="100" data-astro-cid-n6ozym62></path> </svg> </div> <ol class="flow depth-fast" data-astro-cid-ld3fmquo> <li data-astro-cid-ld3fmquo> <article data-astro-cid-ld3fmquo> <b data-astro-cid-ld3fmquo>01</b> <div data-astro-cid-ld3fmquo> <strong data-astro-cid-ld3fmquo>Brief</strong> <span data-astro-cid-ld3fmquo>Goal, owned files, dependencies, non-goals, acceptance.</span> </div> </article> </li><li data-astro-cid-ld3fmquo> <article data-astro-cid-ld3fmquo> <b data-astro-cid-ld3fmquo>02</b> <div data-astro-cid-ld3fmquo> <strong data-astro-cid-ld3fmquo>Isolation</strong> <span data-astro-cid-ld3fmquo>One branch and worktree per independent change.</span> </div> </article> </li><li data-astro-cid-ld3fmquo> <article data-astro-cid-ld3fmquo> <b data-astro-cid-ld3fmquo>03</b> <div data-astro-cid-ld3fmquo> <strong data-astro-cid-ld3fmquo>Evidence</strong> <span data-astro-cid-ld3fmquo>Commands, result, changed files, screenshots, gaps.</span> </div> </article> </li> </ol> </section> </main> <section class="footer" data-astro-cid-bmvnf73n> <nav class="links" aria-label="Chapter navigation" data-astro-cid-bmvnf73n> <nav class="links" aria-label="Chapter navigation" data-astro-cid-lxoypzh2> <a href="/ai-for-dummies/models/" data-astro-cid-lxoypzh2>Previous: models →</a> <a href="/ai-for-dummies/rules/" data-astro-cid-lxoypzh2>Rules case study →</a> <a href="/ai-for-dummies/hands-on/rules/" data-astro-cid-lxoypzh2>Try the rules lab →</a> </nav> </nav> <div class="text" data-astro-cid-bmvnf73n> </div> </section> </body></html> |