chore: publish 79920c9
Built from main 79920c9e6c
feat: give the chapters motion, diagrams, and retrieval practice
This commit is contained in:
Marcos Paulo
+8
-2
@@ -1,2 +1,8 @@
|
||||
<!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.CVOStimI.css"><link rel="stylesheet" href="/ai-for-dummies/fonts/fonts.css"><link rel="stylesheet" href="/ai-for-dummies/_astro/base.Dfo_cwQJ.css"><link rel="stylesheet" href="/ai-for-dummies/_astro/chapters.Bvwgp4pJ.css"><style>.top[data-astro-cid-xattfbdu]{display:flex;align-items:baseline;justify-content:space-between;gap:20px;padding:24px 0;border-bottom:1px solid var(--line);font:700 var(--step-0) var(--font-mono);letter-spacing:.08em;text-transform:uppercase}.top[data-astro-cid-xattfbdu] a{color:var(--ink);text-decoration:none}.top[data-astro-cid-xattfbdu] a:focus-visible{outline:3px solid var(--red);outline-offset:2px}@media(max-width:560px){.cell[data-astro-cid-xattfbdu]:nth-child(2){display:none}}.footer[data-astro-cid-bmvnf73n]{padding:30px 0 70px;color:var(--muted);font-size:clamp(13px,13px,13px)}.links[data-astro-cid-bmvnf73n]{display:flex;flex-wrap:wrap;gap:10px;margin:28px 0 70px}.links[data-astro-cid-bmvnf73n] a{padding:10px 13px;color:var(--ink);border:1px solid var(--ink);text-decoration:none;font:var(--step-0) var(--font-mono);text-transform:uppercase}.links[data-astro-cid-bmvnf73n] a:hover{color:var(--paper);background:var(--ink)}.links[data-astro-cid-bmvnf73n] a:focus-visible{outline:3px solid var(--red);outline-offset:2px}.eyebrow[data-astro-cid-4yr5atew]{margin:0;font:600 var(--step-0) "DM Mono",monospace;letter-spacing:.1em;text-transform:uppercase}.tone-accent[data-astro-cid-4yr5atew]{color:var(--accent)}.tone-gold[data-astro-cid-4yr5atew]{color:var(--gold)}.tone-red[data-astro-cid-4yr5atew]{color:var(--red)}.hero[data-astro-cid-7xzskqga]{padding:100px 0 70px;max-width:950px}h1[data-astro-cid-7xzskqga]{margin:16px 0;font-size:clamp(52px,9vw,126px);line-height:.9;letter-spacing:-.07em}h1[data-astro-cid-7xzskqga] em{font:400 .9em Georgia,serif;color:var(--red)}.intro[data-astro-cid-7xzskqga] p{max-width:680px;margin:0;color:var(--muted);font-size:clamp(20px,20px,20px)}@media(max-width:800px){.hero[data-astro-cid-7xzskqga]{padding:65px 0 45px}}@media(max-width:560px){h1[data-astro-cid-7xzskqga]{font-size:clamp(56px,56px,56px)}.intro[data-astro-cid-7xzskqga] p{font-size:clamp(17px,17px,17px)}}
|
||||
</style></head> <body> <header class="top" id="top" data-astro-cid-xattfbdu> <div class="cell" data-astro-cid-xattfbdu><a href="/ai-for-dummies/summary/">← ROUTE MAP</a></div> <div class="cell" data-astro-cid-xattfbdu><span>02 / AGENTS & TREES</span></div> <div class="cell" data-astro-cid-xattfbdu><a href="/ai-for-dummies/full-guide/">field guide ↗</a></div> </header> <main> <section class="hero" data-astro-cid-7xzskqga> <p data-astro-cid-4yr5atew="true" class="eyebrow tone-red">Subagent workflow</p> <h1 data-astro-cid-7xzskqga><span>One branch<br>per <em>hand.</em></span></h1> <div class="intro" data-astro-cid-7xzskqga> <p>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"> <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> </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"> <a href="/ai-for-dummies/models/">Previous: models →</a> <a href="/ai-for-dummies/rules/">Rules case study →</a> <a href="/ai-for-dummies/hands-on/rules/">Try the rules lab →</a> </nav> </nav> <div class="text" data-astro-cid-bmvnf73n> </div> </section> </body></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>
|
||||
Reference in New Issue
Block a user