bf2f59e292
Built from main 4ae9c5ffef
Merge branch 'refactor/task-21-batch1-corrections'
14 lines
17 KiB
HTML
14 lines
17 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="canonical" href="https://netcracker.pages.marcospaulo.dev.br/ai-for-dummies/agents/"><link rel="icon" type="image/svg+xml" href="/ai-for-dummies/favicon.svg"><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.u_-OWNC4.css"><link rel="stylesheet" href="/ai-for-dummies/_astro/chapters.DVZ6ptlR.css"><link rel="stylesheet" href="/ai-for-dummies/_astro/motion.CtPv1C_R.css"><link rel="stylesheet" href="/ai-for-dummies/_astro/agents@_@astro.TiH4HiC7.css">
|
|
<link rel="stylesheet" href="/ai-for-dummies/_astro/ChapterLayout.BpAlYsUl.css">
|
|
<link rel="stylesheet" href="/ai-for-dummies/_astro/ChapterHero.Bf5I54SK.css">
|
|
<link rel="stylesheet" href="/ai-for-dummies/_astro/FilmPlayer.B1nrpPmm.css">
|
|
<link rel="stylesheet" href="/ai-for-dummies/_astro/require-field.D8D5Or_Q.css">
|
|
<link rel="stylesheet" href="/ai-for-dummies/_astro/WorktreeMap.Dwo7bA_e.css"><script type="module" src="/ai-for-dummies/_astro/page.DGRhADao.js"></script></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><div class="lang-switch" aria-label="Language" data-language-toggle> <button class="active" data-lang="en" aria-pressed="true">EN</button> <span>/</span> <button data-lang="pt" aria-pressed="false">PT</button> </div> <script type="module">function o(t){const n=t.querySelectorAll("[data-lang]");function l(e){document.documentElement.lang=e==="pt"?"pt-BR":"en",n.forEach(a=>{const u=a.dataset.lang===e;a.classList.toggle("active",u),a.setAttribute("aria-pressed",String(u))}),document.querySelectorAll("[data-language-content]").forEach(a=>{a.hidden=a.dataset.languageContent!==e}),window.dispatchEvent(new CustomEvent("ai-for-dummies:languagechange",{detail:{language:e}}))}function g(e){return e==="pt"?"pt":"en"}n.forEach(e=>{e.addEventListener("click",()=>{const a=g(e.dataset.lang);l(a);try{localStorage.setItem("ai-for-dummies-language",a)}catch{}})});let c="en";try{c=localStorage.getItem("ai-for-dummies-language")||"en"}catch{}l(g(c))}document.querySelectorAll("[data-language-toggle]").forEach(t=>{"requestIdleCallback"in window?window.requestIdleCallback(()=>o(t)):setTimeout(()=>o(t),0)});</script></div> </header> <main> <section class="hero rise-in has-aside" data-astro-cid-7xzskqga> <div class="hero-copy" data-astro-cid-7xzskqga> <div data-language-content="en" data-astro-cid-7xzskqga><p data-astro-cid-4yr5atew="true" class="eyebrow tone-red">Subagent workflow</p> </div> <div data-language-content="pt" hidden data-astro-cid-7xzskqga><p data-astro-cid-4yr5atew="true" class="eyebrow tone-red">Fluxo de subagentes</p> </div> <h1 class="parallax-near" data-astro-cid-7xzskqga><span data-language-content="en" data-astro-cid-lxoypzh2>One branch<br>per <em>hand.</em></span><span data-language-content="pt" hidden data-astro-cid-lxoypzh2>Uma branch<br>por <em>mão.</em></span></h1> <div class="intro parallax-far" data-astro-cid-7xzskqga> <p data-language-content="en" 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> <p data-language-content="pt" hidden data-astro-cid-lxoypzh2>Agentes funcionam quando papéis, arquivos e evidências são delimitados. Um worktree dá a cada agente seu próprio checkout enquanto o orquestrador protege a intenção.</p> </div> </div> <div class="hero-aside rise-in-late" data-astro-cid-7xzskqga> <figure class="film film-hero" data-film data-paused="true" data-astro-cid-5bv36nto> <div class="frame" data-astro-cid-5bv36nto> <video data-language-content="en" src="/ai-for-dummies/videos/agents-en.mp4" poster="/ai-for-dummies/videos/agents-en.jpg" width="1280" height="720" muted loop playsinline preload="none" aria-label="02 / Agents & worktrees. One task, too big for one context. Split at the seams: one worktree each. Each works in isolation: no shared half-edits. Each returns a diff and the proof it works. The orchestrator checks, then merges. One branch per hand. Evidence comes back." data-astro-cid-5bv36nto></video><video data-language-content="pt" hidden src="/ai-for-dummies/videos/agents-pt.mp4" poster="/ai-for-dummies/videos/agents-pt.jpg" width="1280" height="720" muted loop playsinline preload="none" aria-label="02 / Agentes e worktrees. Uma tarefa grande demais para um contexto. Divida nas costuras: uma worktree cada. Cada um trabalha isolado: sem edições pela metade. Cada um devolve um diff e a prova de que funciona. O orquestrador confere e faz o merge. Um branch por mão. A evidência volta." data-astro-cid-5bv36nto></video> <button class="toggle" type="button" data-film-toggle aria-pressed="false" data-astro-cid-5bv36nto> <svg class="icon-play" viewBox="0 0 16 16" aria-hidden="true" data-astro-cid-5bv36nto><path d="M4 2.5v11l9-5.5z" fill="currentColor" data-astro-cid-5bv36nto></path></svg> <svg class="icon-pause" viewBox="0 0 16 16" aria-hidden="true" data-astro-cid-5bv36nto><path d="M3.5 2.5h3v11h-3zm6 0h3v11h-3z" fill="currentColor" data-astro-cid-5bv36nto></path></svg> <span class="sr-only" data-language-content="en" data-astro-cid-5bv36nto> <span class="when-paused" data-astro-cid-5bv36nto>Play film</span> <span class="when-playing" data-astro-cid-5bv36nto>Pause film</span> </span><span class="sr-only" data-language-content="pt" hidden data-astro-cid-5bv36nto> <span class="when-paused" data-astro-cid-5bv36nto>Reproduzir filme</span> <span class="when-playing" data-astro-cid-5bv36nto>Pausar filme</span> </span> </button> <span class="progress" aria-hidden="true" data-astro-cid-5bv36nto><span data-film-progress data-astro-cid-5bv36nto></span></span> </div> <figcaption data-astro-cid-5bv36nto> <span class="meta" data-language-content="en" data-astro-cid-5bv36nto> Film · 24 s · silent, captioned </span><span class="meta" data-language-content="pt" hidden data-astro-cid-5bv36nto> Filme · 24 s · sem som, com legendas </span> <details data-astro-cid-5bv36nto> <summary data-astro-cid-5bv36nto> <span data-language-content="en" data-astro-cid-5bv36nto> Transcript </span><span data-language-content="pt" hidden data-astro-cid-5bv36nto> Transcrição </span> </summary> <ol data-language-content="en" data-astro-cid-5bv36nto> <li data-astro-cid-5bv36nto>One task, too big for one context.</li><li data-astro-cid-5bv36nto>Split at the seams: one worktree each.</li><li data-astro-cid-5bv36nto>Each works in isolation: no shared half-edits.</li><li data-astro-cid-5bv36nto>Each returns a diff and the proof it works.</li><li data-astro-cid-5bv36nto>The orchestrator checks, then merges.</li><li data-astro-cid-5bv36nto>One branch per hand. Evidence comes back.</li> </ol><ol data-language-content="pt" hidden data-astro-cid-5bv36nto> <li data-astro-cid-5bv36nto>Uma tarefa grande demais para um contexto.</li><li data-astro-cid-5bv36nto>Divida nas costuras: uma worktree cada.</li><li data-astro-cid-5bv36nto>Cada um trabalha isolado: sem edições pela metade.</li><li data-astro-cid-5bv36nto>Cada um devolve um diff e a prova de que funciona.</li><li data-astro-cid-5bv36nto>O orquestrador confere e faz o merge.</li><li data-astro-cid-5bv36nto>Um branch por mão. A evidência volta.</li> </ol> </details> </figcaption> </figure> <script type="module">const o=()=>window.matchMedia("(prefers-reduced-motion: reduce)").matches;function l(e){return e.videos.find(t=>!t.hidden)}function a(e){const t=e.videos.some(s=>!s.paused);e.root.dataset.paused=String(!t),e.button.setAttribute("aria-pressed",String(t))}function u(e){e.videos.forEach(s=>{s.hidden&&s.pause()});const t=l(e);t&&(t.preload="auto",t.play().catch(()=>a(e)))}function c(e){e.videos.forEach(t=>t.pause())}function d(e){e.inView&&!e.userPaused&&!o()?u(e):c(e)}function f(){const e=[];if(document.querySelectorAll("[data-film]").forEach(t=>{if(t.dataset.filmWired)return;t.dataset.filmWired="true";const s=t.querySelector("[data-film-toggle]");if(!s)return;const n={root:t,videos:[...t.querySelectorAll("video")],bar:t.querySelector("[data-film-progress]"),button:s,inView:!1,userPaused:o()};n.videos.forEach(r=>{r.addEventListener("play",()=>a(n)),r.addEventListener("pause",()=>a(n)),r.addEventListener("timeupdate",()=>{!n.bar||!r.duration||(n.bar.style.transform=`scaleX(${r.currentTime/r.duration})`)})}),s.addEventListener("click",()=>{const r=n.videos.some(i=>!i.paused);n.userPaused=r,r?c(n):u(n)}),e.push(n)}),!!e.length){if("IntersectionObserver"in window){const t=new IntersectionObserver(s=>{s.forEach(n=>{const r=e.find(i=>i.root===n.target);r&&(r.inView=n.isIntersecting,d(r))})},{threshold:.4});e.forEach(s=>t.observe(s.root))}window.addEventListener("ai-for-dummies:languagechange",()=>e.forEach(d))}}f();</script> </div> </section> <section class="pipeline reveal" data-astro-cid-lxoypzh2> <div class="depth-slow" data-astro-cid-lxoypzh2> <p class="eyebrow" data-language-content="en">The tree</p> <p class="eyebrow" data-language-content="pt" hidden>A árvore</p> <h2 data-language-content="en" data-astro-cid-lxoypzh2>Split at<br>the <em>seam.</em></h2> <h2 data-language-content="pt" hidden data-astro-cid-lxoypzh2>Divida na<br><em>costura.</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-language-content="en">MAIN / ORCHESTRATOR</strong> <strong data-language-content="pt" hidden>MAIN / ORQUESTRADOR</strong> <code data-language-content="en" 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> <code data-language-content="pt" hidden data-astro-cid-lxoypzh2>├── agent/ui → componentes + estados visuais
|
|
├── agent/tests → aceitação + regressões
|
|
└── agent/docs → guia + exemplos
|
|
|
|
faça merge depois que cada folha devolver um diff e evidências</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-language-content="en" data-astro-cid-lxoypzh2>FRAME</b> <b data-language-content="pt" hidden data-astro-cid-lxoypzh2> ENQUADRAR </b> <h2 data-language-content="en" data-astro-cid-lxoypzh2>Orchestrator</h2> <h2 data-language-content="pt" hidden data-astro-cid-lxoypzh2> Orquestrador </h2> <p data-language-content="en" data-astro-cid-lxoypzh2>Owns scope, task graph, boundaries, and integration.</p> <p data-language-content="pt" hidden data-astro-cid-lxoypzh2> Dono do escopo, do grafo de tarefas, das fronteiras e da integração. </p> </article><article class="card" data-astro-cid-lxoypzh2> <b data-language-content="en" data-astro-cid-lxoypzh2>HAND OFF</b> <b data-language-content="pt" hidden data-astro-cid-lxoypzh2> PASSAR </b> <h2 data-language-content="en" data-astro-cid-lxoypzh2>Worker</h2> <h2 data-language-content="pt" hidden data-astro-cid-lxoypzh2> Agente </h2> <p data-language-content="en" data-astro-cid-lxoypzh2>Owns one coherent slice and one worktree.</p> <p data-language-content="pt" hidden data-astro-cid-lxoypzh2> Dono de uma fatia coerente e de um worktree. </p> </article><article class="card" data-astro-cid-lxoypzh2> <b data-language-content="en" data-astro-cid-lxoypzh2>PROVE</b> <b data-language-content="pt" hidden data-astro-cid-lxoypzh2> COMPROVAR </b> <h2 data-language-content="en" data-astro-cid-lxoypzh2>Verifier</h2> <h2 data-language-content="pt" hidden data-astro-cid-lxoypzh2> Verificador </h2> <p data-language-content="en" data-astro-cid-lxoypzh2>Re-runs gates and reports remaining gaps.</p> <p data-language-content="pt" hidden data-astro-cid-lxoypzh2> Roda gates novamente e reporta o que ainda falta. </p> </article> </section> <section class="practice reveal" data-astro-cid-lxoypzh2> <div class="depth-slow" data-astro-cid-lxoypzh2> <p class="eyebrow" data-language-content="en">Handoff</p> <p class="eyebrow" data-language-content="pt" hidden>Passagem</p> <h2 data-language-content="en" data-astro-cid-lxoypzh2>Context that<br>can <em>travel.</em></h2> <h2 data-language-content="pt" hidden data-astro-cid-lxoypzh2>Contexto que<br>pode <em>viajar.</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-language-content="en" data-astro-cid-ld3fmquo>Brief</strong> <strong data-language-content="pt" hidden data-astro-cid-ld3fmquo>Brief</strong> <span data-language-content="en" data-astro-cid-ld3fmquo>Goal, owned files, dependencies, non-goals, acceptance.</span> <span data-language-content="pt" hidden data-astro-cid-ld3fmquo>Objetivo, arquivos sob sua posse, dependências, fora de escopo, aceitação.</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-language-content="en" data-astro-cid-ld3fmquo>Isolation</strong> <strong data-language-content="pt" hidden data-astro-cid-ld3fmquo>Isolamento</strong> <span data-language-content="en" data-astro-cid-ld3fmquo>One branch and worktree per independent change.</span> <span data-language-content="pt" hidden data-astro-cid-ld3fmquo>Uma branch e um worktree por mudança independente.</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-language-content="en" data-astro-cid-ld3fmquo>Evidence</strong> <strong data-language-content="pt" hidden data-astro-cid-ld3fmquo>Evidência</strong> <span data-language-content="en" data-astro-cid-ld3fmquo>Commands, result, changed files, screenshots, gaps.</span> <span data-language-content="pt" hidden data-astro-cid-ld3fmquo>Comandos, resultado, arquivos alterados, capturas de tela, lacunas.</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> |