chore: publish 79920c9

Built from main 79920c9e6c
feat: give the chapters motion, diagrams, and retrieval practice
This commit is contained in:
Marcos Paulo
2026-09-06 16:26:38 -03:00
parent 7ec41b8cf5
commit 2cda37b553
25 changed files with 72 additions and 28 deletions
+5 -2
View File
@@ -1,2 +1,5 @@
<!DOCTYPE html><html lang="en"> <head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>AI For Dummies — Models</title><meta name="description" content="A model has a capability ceiling. Effort controls how much room it gets to reason. Route by uncertainty and verification cost."><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>01 / MODELS</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">Model routing</p> <h1 data-astro-cid-7xzskqga><span>Choose the<br><em>engine.</em></span></h1> <div class="intro" data-astro-cid-7xzskqga> <p>A model has a capability ceiling. Effort controls how much room it gets to reason. Route by uncertainty and verification cost.</p> </div> </section> <section class="grid"> <article class="card"> <b>LOW</b> <h2>Bounded rhythm</h2> <p>Lookup, small edits, formatting, and transformations with clear checks.</p> </article><article class="card"> <b>MEDIUM</b> <h2>Default work</h2> <p>Normal implementation where the contract is clear but context matters.</p> </article><article class="card"> <b>HIGH</b> <h2>Ambiguity</h2> <p>Planning, architecture, security judgment, and hard failures.</p> </article> </section> <section class="model"> <div> <p class="eyebrow">Two knobs</p> <h2>Capability<br>× effort</h2> </div> <div class="panel"> <strong>ROUTING RULE</strong> <code>strong model + high effort → frame ambiguity · light model + low effort → bounded execution · raise one knob at a time → compare evidence</code> </div> </section> <section class="practice"> <div> <p class="eyebrow">Sequence</p> <h2>Spend judgment<br>where it <em>compounds.</em></h2> </div> <div class="steps"> <article> <b>01</b> <div> <strong>Plan</strong> <span>Strong model: scope, risks, acceptance, and worktree split.</span> </div> </article><article> <b>02</b> <div> <strong>Build</strong> <span>Focused worker: smallest context and lightest model that can pass.</span> </div> </article><article> <b>03</b> <div> <strong>Review</strong> <span>Independent pass when missed issues cost more than the call.</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/agents/">Next: agents & trees →</a> <a href="/ai-for-dummies/rules/">Rules case study →</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 — Models</title><meta name="description" content="A model has a capability ceiling. Effort controls how much room it gets to reason. Route by uncertainty and verification cost."><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/models.DC2DUDWN.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"></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-wmd6b3pc>← ROUTE MAP</a></div> <div class="cell" data-astro-cid-xattfbdu><span data-astro-cid-wmd6b3pc>01 / MODELS</span></div> <div class="cell" data-astro-cid-xattfbdu><a href="/ai-for-dummies/full-guide/" data-astro-cid-wmd6b3pc>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">Model routing</p> <h1 class="parallax-near" data-astro-cid-7xzskqga><span data-astro-cid-wmd6b3pc>Choose the<br><em>engine.</em></span></h1> <div class="intro parallax-far" data-astro-cid-7xzskqga> <p data-astro-cid-wmd6b3pc>A model has a capability ceiling. Effort controls how much room it gets to reason. Route by uncertainty and verification cost.</p> </div> </section> <section class="grid reveal" data-astro-cid-wmd6b3pc> <article class="card" data-astro-cid-wmd6b3pc> <b data-astro-cid-wmd6b3pc>LOW</b> <h2 data-astro-cid-wmd6b3pc>Bounded rhythm</h2> <p data-astro-cid-wmd6b3pc>Lookup, small edits, formatting, and transformations with clear checks.</p> </article><article class="card" data-astro-cid-wmd6b3pc> <b data-astro-cid-wmd6b3pc>MEDIUM</b> <h2 data-astro-cid-wmd6b3pc>Default work</h2> <p data-astro-cid-wmd6b3pc>Normal implementation where the contract is clear but context matters.</p> </article><article class="card" data-astro-cid-wmd6b3pc> <b data-astro-cid-wmd6b3pc>HIGH</b> <h2 data-astro-cid-wmd6b3pc>Ambiguity</h2> <p data-astro-cid-wmd6b3pc>Planning, architecture, security judgment, and hard failures.</p> </article> </section> <section class="model reveal" data-astro-cid-wmd6b3pc> <div class="depth-slow" data-astro-cid-wmd6b3pc> <p class="eyebrow" data-astro-cid-wmd6b3pc>Two knobs</p> <h2 data-astro-cid-wmd6b3pc>Capability<br>× effort</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-wmd6b3pc> <strong data-astro-cid-wmd6b3pc>ROUTING RULE</strong> <code data-astro-cid-wmd6b3pc>strong model + high effort → frame ambiguity
light model + low effort → bounded execution
raise one knob at a time → compare evidence</code> </div> </section> <section class="practice reveal" data-astro-cid-wmd6b3pc> <div class="depth-slow" data-astro-cid-wmd6b3pc> <p class="eyebrow" data-astro-cid-wmd6b3pc>Sequence</p> <h2 data-astro-cid-wmd6b3pc>Spend judgment<br>where it <em>compounds.</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>Plan</strong> <span data-astro-cid-ld3fmquo>Strong model: scope, risks, acceptance, and worktree split.</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>Build</strong> <span data-astro-cid-ld3fmquo>Focused worker: smallest context and lightest model that can pass.</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>Review</strong> <span data-astro-cid-ld3fmquo>Independent pass when missed issues cost more than the call.</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-wmd6b3pc> <a href="/ai-for-dummies/agents/" data-astro-cid-wmd6b3pc>Next: agents & trees →</a> <a href="/ai-for-dummies/rules/" data-astro-cid-wmd6b3pc>Rules case study →</a> </nav> </nav> <div class="text" data-astro-cid-bmvnf73n> </div> </section> </body></html>