chore: publish 61de2f6

Built from main 61de2f6270
fix: unify typography and review interactions
This commit is contained in:
Marcos Paulo
2026-09-06 16:36:26 +00:00
parent 80f557d429
commit 7ec41b8cf5
11 changed files with 15 additions and 13 deletions
+1
View File
@@ -0,0 +1 @@
body{font-family:var(--font-sans)}button,input,textarea,select{font:inherit}code,kbd,pre,samp{font-family:var(--font-mono)}a{text-decoration-thickness:1px;text-underline-offset:.18em;transition:color .18s cubic-bezier(.2,0,0,1),text-decoration-color .18s cubic-bezier(.2,0,0,1)}a:hover{text-decoration-color:currentcolor}@media(prefers-reduced-motion:reduce){a{transition:none}}
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
+1 -1
View File
@@ -1,2 +1,2 @@
<!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/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) monospace;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) monospace;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)}}
<!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>
+1 -1
View File
@@ -1,4 +1,4 @@
<!DOCTYPE html><html lang="en"> <head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>AI For Dummies — Field Guide</title><meta name="description" content="AI For Dummies: a field guide to skills, models, subagents, and worktrees."><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/full-guide.Dpq4G4E0.css">
<!DOCTYPE html><html lang="en"> <head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>AI For Dummies — Field Guide</title><meta name="description" content="AI For Dummies: a field guide to skills, models, subagents, and worktrees."><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/full-guide.Dpq4G4E0.css">
<link rel="stylesheet" href="/ai-for-dummies/_astro/full-guide.D-JsEpCu.css"></head> <body> <div class="reading-progress" aria-hidden="true"> <span data-reading-progress-span></span> </div> <script>(function(){const selector = ".reading-progress span";
// ReadingProgress island — passive scroll listener.
+2 -2
View File
@@ -1,3 +1,3 @@
<!DOCTYPE html><html lang="en"> <head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>AI For Dummies — Start here</title><meta name="description" content="AI For Dummies: a practical route map for models, agents, worktrees, skills, rules, and verification."><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/chapters.Bvwgp4pJ.css"><style>.grid[data-astro-cid-65v63m4u]{display:grid;grid-template-columns:repeat(var(--columns),1fr);gap:1px;background:var(--line)}.grid[data-astro-cid-65v63m4u]>*{background:var(--paper)}@media(max-width:800px){.grid[data-astro-cid-65v63m4u]{grid-template-columns:1fr}}.card[data-astro-cid-4yogs2gu]{display:flex;min-width:0;flex-direction:column;min-height:220px;padding:28px;background:var(--paper)}.card[data-astro-cid-4yogs2gu] b[data-astro-cid-4yogs2gu]{color:var(--red);font-size:var(--step-24);font-family:ui-monospace,monospace}.card[data-astro-cid-4yogs2gu] h2[data-astro-cid-4yogs2gu]{margin:18px 0 8px;font-size:var(--step-25);letter-spacing:-.04em}.card[data-astro-cid-4yogs2gu] p[data-astro-cid-4yogs2gu]{margin:0 0 14px;color:var(--muted)}.card[data-astro-cid-4yogs2gu] a[data-astro-cid-4yogs2gu]{margin-top:auto;color:var(--blue);font-weight:700;text-decoration:none}.card[data-astro-cid-4yogs2gu] a[data-astro-cid-4yogs2gu]:focus-visible{outline:3px solid var(--red);outline-offset:2px}@media(max-width:560px){.card[data-astro-cid-4yogs2gu]{min-height:0}}.guide-launch[data-astro-cid-j7pv25f6]{display:inline-flex;gap:14px;align-items:center;margin-top:20px;padding:12px 16px;background:var(--ink);color:var(--paper);font:700 var(--step-12) ui-monospace,monospace;letter-spacing:.06em;text-decoration:none;text-transform:uppercase;transition:transform .2s ease,background .2s ease}.guide-launch[data-astro-cid-j7pv25f6]:hover{transform:translateY(-3px);background:var(--blue)}.guide-launch[data-astro-cid-j7pv25f6] span[data-astro-cid-j7pv25f6]{color:var(--gold);font-size:var(--step-22);line-height:0}.landing-note[data-astro-cid-j7pv25f6]{display:grid;grid-template-columns:170px minmax(0,1fr);gap:30px;margin:0 0 70px;padding:25px 0;border-top:1px solid var(--ink);border-bottom:1px solid var(--ink)}.landing-note[data-astro-cid-j7pv25f6] span[data-astro-cid-j7pv25f6]{color:var(--red);font:700 var(--step-0) ui-monospace,monospace;letter-spacing:.1em}.landing-note[data-astro-cid-j7pv25f6] strong[data-astro-cid-j7pv25f6]{font-size:var(--step-4);line-height:1.08;letter-spacing:-.04em}@media(max-width:560px){.landing-note[data-astro-cid-j7pv25f6]{grid-template-columns:1fr;gap:9px;margin-bottom:45px}}@media(prefers-reduced-motion:reduce){.guide-launch[data-astro-cid-j7pv25f6]{transition:none}.guide-launch[data-astro-cid-j7pv25f6]:hover{transform:none}}
.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) monospace;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) monospace;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)}}
<!DOCTYPE html><html lang="en"> <head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>AI For Dummies — Start here</title><meta name="description" content="AI For Dummies: a practical route map for models, agents, worktrees, skills, rules, and verification."><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>.grid[data-astro-cid-65v63m4u]{display:grid;grid-template-columns:repeat(var(--columns),1fr);gap:1px;background:var(--line)}.grid[data-astro-cid-65v63m4u]>*{background:var(--paper)}@media(max-width:800px){.grid[data-astro-cid-65v63m4u]{grid-template-columns:1fr}}.card[data-astro-cid-4yogs2gu]{display:flex;min-width:0;flex-direction:column;min-height:220px;padding:28px;background:var(--paper)}.card[data-astro-cid-4yogs2gu] b[data-astro-cid-4yogs2gu]{color:var(--red);font-size:var(--step-24);font-family:ui-monospace,monospace}.card[data-astro-cid-4yogs2gu] h2[data-astro-cid-4yogs2gu]{margin:18px 0 8px;font-size:var(--step-25);letter-spacing:-.04em}.card[data-astro-cid-4yogs2gu] p[data-astro-cid-4yogs2gu]{margin:0 0 14px;color:var(--muted)}.card[data-astro-cid-4yogs2gu] a[data-astro-cid-4yogs2gu]{margin-top:auto;color:var(--blue);font-weight:700;text-decoration:none}.card[data-astro-cid-4yogs2gu] a[data-astro-cid-4yogs2gu]:focus-visible{outline:3px solid var(--red);outline-offset:2px}@media(max-width:560px){.card[data-astro-cid-4yogs2gu]{min-height:0}}.guide-launch[data-astro-cid-j7pv25f6]{display:inline-flex;gap:14px;align-items:center;margin-top:20px;padding:12px 16px;background:var(--ink);color:var(--paper);font:700 var(--step-12) var(--font-mono);letter-spacing:.06em;text-decoration:none;text-transform:uppercase;transition:transform .2s ease,background .2s ease}.guide-launch[data-astro-cid-j7pv25f6]:hover{transform:translateY(-3px);background:var(--blue)}.guide-launch[data-astro-cid-j7pv25f6] span[data-astro-cid-j7pv25f6]{color:var(--gold);font-size:var(--step-22);line-height:0}.landing-note[data-astro-cid-j7pv25f6]{display:grid;grid-template-columns:170px minmax(0,1fr);gap:30px;margin:0 0 70px;padding:25px 0;border-top:1px solid var(--ink);border-bottom:1px solid var(--ink)}.landing-note[data-astro-cid-j7pv25f6] span[data-astro-cid-j7pv25f6]{color:var(--red);font:700 var(--step-0) var(--font-mono);letter-spacing:.1em}.landing-note[data-astro-cid-j7pv25f6] strong[data-astro-cid-j7pv25f6]{font-size:var(--step-4);line-height:1.08;letter-spacing:-.04em}@media(max-width:560px){.landing-note[data-astro-cid-j7pv25f6]{grid-template-columns:1fr;gap:9px;margin-bottom:45px}}@media(prefers-reduced-motion:reduce){.guide-launch[data-astro-cid-j7pv25f6]{transition:none}.guide-launch[data-astro-cid-j7pv25f6]:hover{transform:none}}
.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/" aria-current="page" data-astro-cid-j7pv25f6>AI FOR DUMMIES</a></div> <div class="cell" data-astro-cid-xattfbdu><span data-astro-cid-j7pv25f6>00 / START HERE</span></div> <div class="cell" data-astro-cid-xattfbdu><a href="/ai-for-dummies/skills-review/" data-astro-cid-j7pv25f6>review desk ↗</a></div> </header> <main> <section class="hero" data-astro-cid-7xzskqga> <p data-astro-cid-4yr5atew="true" class="eyebrow tone-red">The short route</p> <h1 data-astro-cid-7xzskqga><span data-astro-cid-j7pv25f6>Ship the<br><em>system.</em></span></h1> <div class="intro" data-astro-cid-7xzskqga> <p data-astro-cid-j7pv25f6>Start with the map. Then open the one chapter that matches the decision in front of you: model, agent, worktree, skill, rule, or proof.</p> </div> <a class="guide-launch" href="/ai-for-dummies/full-guide/" data-astro-cid-j7pv25f6>Take the full field guide <span data-astro-cid-j7pv25f6></span></a> </section> <section class="group" aria-label="Guide chapters" data-astro-cid-65v63m4u> <div class="grid" style="--columns: 3" data-astro-cid-65v63m4u> <article class="card" data-astro-cid-4yogs2gu> <b data-astro-cid-4yogs2gu>01</b> <h2 data-astro-cid-4yogs2gu>Models</h2> <p data-astro-cid-4yogs2gu>Capability and effort are separate knobs.</p> <a href="/ai-for-dummies/models/" data-astro-cid-4yogs2gu>Open chapter →</a> </article> <article class="card" data-astro-cid-4yogs2gu> <b data-astro-cid-4yogs2gu>02</b> <h2 data-astro-cid-4yogs2gu>Agents &amp; trees</h2> <p data-astro-cid-4yogs2gu>Bound roles, handoffs, and worktrees.</p> <a href="/ai-for-dummies/agents/" data-astro-cid-4yogs2gu>Open chapter →</a> </article> <article class="card" data-astro-cid-4yogs2gu> <b data-astro-cid-4yogs2gu>03</b> <h2 data-astro-cid-4yogs2gu>Skills</h2> <p data-astro-cid-4yogs2gu>Capture repeatable decisions in small packages.</p> <a href="/ai-for-dummies/skills/" data-astro-cid-4yogs2gu>Open chapter →</a> </article> <article class="card" data-astro-cid-4yogs2gu> <b data-astro-cid-4yogs2gu>04</b> <h2 data-astro-cid-4yogs2gu>Rules</h2> <p data-astro-cid-4yogs2gu>Connect guidance to enforcement.</p> <a href="/ai-for-dummies/rules/" data-astro-cid-4yogs2gu>Open chapter →</a> </article> <article class="card" data-astro-cid-4yogs2gu> <b data-astro-cid-4yogs2gu>05</b> <h2 data-astro-cid-4yogs2gu>Hands-on</h2> <p data-astro-cid-4yogs2gu>Compare a strong prompt with skill-enabled work.</p> <a href="/ai-for-dummies/hands-on/starter/" data-astro-cid-4yogs2gu>Open lab →</a> </article> <article class="card" data-astro-cid-4yogs2gu> <b data-astro-cid-4yogs2gu>06</b> <h2 data-astro-cid-4yogs2gu>Review desk</h2> <p data-astro-cid-4yogs2gu>Browse original packages, references, scripts, and improvements.</p> <a href="/ai-for-dummies/skills-review/" data-astro-cid-4yogs2gu>Open desk →</a> </article> </div> </section> <section class="landing-note" data-astro-cid-j7pv25f6> <span data-astro-cid-j7pv25f6>THE THREAD</span> <strong data-astro-cid-j7pv25f6>Frame uncertainty → isolate execution → preserve judgment → verify the change.</strong> </section> </main> <section class="footer" data-astro-cid-bmvnf73n> <nav class="links" aria-label="Chapter navigation" data-astro-cid-bmvnf73n> </nav> <div class="text" data-astro-cid-bmvnf73n> <span data-astro-cid-j7pv25f6>The route map is now the default entry. The full guide remains available whenever you want the whole narrative.</span> </div> </section> </body></html>
+1 -1
View File
@@ -1,2 +1,2 @@
<!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/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) monospace;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) monospace;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)}}
<!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>
+1 -1
View File
File diff suppressed because one or more lines are too long
+3 -2
View File
@@ -1,4 +1,5 @@
<!DOCTYPE html><html lang="en"> <head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Submitted Skills — Review Desk</title><meta name="description" content="Friendly reviews and improved drafts for submitted Agent Skills."><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/skills-review.H9Gk5YQJ.css"><link rel="stylesheet" href="/ai-for-dummies/_astro/change-lens.BGIvC9Y7.css"></head> <body> <main> <header class="topbar"> <a href="/ai-for-dummies/" class="back">← field guide</a><span>SUBMITTED SKILLS / REVIEW DESK</span><a href="#catalog" id="submission-count">submissions</a> </header> <section class="hero"> <p class="eyebrow">A friendly path from draft to dependable</p> <h1>Every skill deserves<br><em>a clear job.</em></h1> <p>
<!DOCTYPE html><html lang="en"> <head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Submitted Skills — Review Desk</title><meta name="description" content="Friendly reviews and improved drafts for submitted Agent Skills."><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/skills-review.H9Gk5YQJ.css"><link rel="stylesheet" href="/ai-for-dummies/_astro/change-lens.BGIvC9Y7.css"><style>.catalog>aside{position:sticky;top:24px;display:flex;align-self:start;max-height:calc(100dvh - 48px);overflow:hidden}#skill-list{min-height:0;overflow-y:auto;overscroll-behavior:contain;scrollbar-color:var(--blue) var(--paper)}#skill-list button,.file-tabs button,.switch button,.preview button{transition:color .18s cubic-bezier(.2,0,0,1),background-color .18s cubic-bezier(.2,0,0,1),transform .18s cubic-bezier(.2,0,0,1)}#skill-list button:hover,#skill-list button:focus-visible{transform:translate(3px)}.detail>*{animation:review-detail-in .2s cubic-bezier(.2,0,0,1) both}.detail a,.research a{text-decoration-color:color-mix(in srgb,currentColor 45%,transparent)}.detail a:hover,.research a:hover{text-decoration-color:currentColor}@keyframes review-detail-in{0%{opacity:.01;transform:translateY(6px)}to{opacity:1;transform:translateY(0)}}@media(max-width:800px){.catalog>aside{position:static;max-height:none}#skill-list{max-height:50dvh}}@media(prefers-reduced-motion:reduce){#skill-list button,.file-tabs button,.switch button,.preview button{transition:none}.detail>*{animation:none}}
</style></head> <body> <main> <header class="topbar"> <a href="/ai-for-dummies/" class="back">← field guide</a><span>SUBMITTED SKILLS / REVIEW DESK</span><a href="#catalog" id="submission-count">submissions</a> </header> <section class="hero"> <p class="eyebrow">A friendly path from draft to dependable</p> <h1>Every skill deserves<br><em>a clear job.</em></h1> <p>
Read the original, understand what already works, and compare a safer, leaner draft. Nothing
here overwrites a submission; revisions live in their own review output.
</p> </section> <section class="principles" aria-label="Review principles"> <article> <b>01</b><strong>Discoverable</strong><span>A precise description tells an agent when to load the skill.</span> </article> <article> <b>02</b><strong>Useful in context</strong><span>Core workflow stays short; conditional detail loads only when needed.</span> </article> <article> <b>03</b><strong>Safe by design</strong><span>Commands, secrets, and shared systems have explicit boundaries.</span> </article> <article> <b>04</b><strong>Proven in use</strong><span>Real prompts and observable checks turn a draft into a reliable tool.</span> </article> </section> <section class="method"> <div> <p class="eyebrow">How to use this desk</p><h2>Compare.<br><em>Then choose.</em></h2> </div> <ol> <li>Select a submission, or open an author URL.</li><li>
@@ -18,4 +19,4 @@ Share an author with <code>?author=Name</code>, or one review with <code>?author
window.SKILLS_REVIEW_VOTE_API = 'https://ai-for-dummies-vote.marcospaulo.dev.br';
window.__SKILLS_REVIEW_CATALOG = JSON.parse(serializedCatalog);
})();</script> <script type="module" src="/ai-for-dummies/_astro/skills-review.astro_astro_type_script_index_0_lang.CXd69NST.js"></script> </body></html>
})();</script> <script type="module" src="/ai-for-dummies/_astro/skills-review.astro_astro_type_script_index_0_lang.CXd69NST.js"></script> </body></html>
+2 -2
View File
@@ -1,5 +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 — Skills</title><meta name="description" content="A skill changes behavior. Keep the trigger precise, put the workflow in SKILL.md, and move conditional facts, scripts, and examples into focused files."><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/chapters.Bvwgp4pJ.css"><style>.package-workbench[data-astro-cid-xk5n4466]{display:grid;grid-template-columns:minmax(190px,.85fr) minmax(0,1.3fr);min-width:0;background:var(--ink);border:1px solid var(--ink);box-shadow:10px 10px color-mix(in srgb,var(--gold) 55%,transparent)}.package-tree[data-astro-cid-xk5n4466]{padding:22px 16px;border-right:1px solid var(--muted);min-width:0}.package-tree[data-astro-cid-xk5n4466]>p[data-astro-cid-xk5n4466],.package-preview[data-astro-cid-xk5n4466]>span[data-astro-cid-xk5n4466]{margin:0 0 14px;color:var(--gold);font:700 var(--step-0) / 1.35 ui-monospace,monospace;letter-spacing:.1em}.package-tree[data-astro-cid-xk5n4466] button[data-astro-cid-xk5n4466]{display:grid;grid-template-columns:minmax(0,1fr) auto;align-items:center;gap:8px;width:100%;padding:12px 8px;border:0;border-left:2px solid transparent;background:transparent;color:var(--line);text-align:left;cursor:pointer;transition:background .2s ease,border-color .2s ease,transform .2s ease}.package-tree[data-astro-cid-xk5n4466] button[data-astro-cid-xk5n4466]:hover,.package-tree[data-astro-cid-xk5n4466] button[data-astro-cid-xk5n4466]:focus-visible,.package-tree[data-astro-cid-xk5n4466] button[data-astro-cid-xk5n4466].active{border-left-color:var(--gold);background:var(--blue);outline:0}.package-tree[data-astro-cid-xk5n4466] button[data-astro-cid-xk5n4466]:hover{transform:translate(3px)}.package-tree[data-astro-cid-xk5n4466] code[data-astro-cid-xk5n4466]{min-width:0;overflow-wrap:anywhere;font:700 13px/1.4 ui-monospace,monospace}.package-tree[data-astro-cid-xk5n4466] small[data-astro-cid-xk5n4466]{color:var(--muted);font:11px/1.25 Arial,sans-serif;text-align:right}.package-preview[data-astro-cid-xk5n4466]{min-width:0;padding:26px;background:var(--ink);color:var(--paper)}.package-preview[data-astro-cid-xk5n4466] h3[data-astro-cid-xk5n4466]{margin:0 0 8px;font-size:clamp(24px,3vw,38px);line-height:1.02;letter-spacing:-.045em}.package-preview[data-astro-cid-xk5n4466] p[data-astro-cid-xk5n4466]{max-width:52ch;margin:0;color:var(--line)}.package-preview[data-astro-cid-xk5n4466] pre[data-astro-cid-xk5n4466]{max-width:100%;margin:20px 0 0;padding:15px;overflow:auto;border:1px solid var(--muted);background:var(--deep);color:var(--line);font:12px/1.55 ui-monospace,monospace}.package-preview[data-astro-cid-xk5n4466].is-swapping{animation:package-preview-in .2s cubic-bezier(.2,0,0,1) both}@keyframes package-preview-in{0%{opacity:.25;transform:translateY(7px)}to{opacity:1;transform:translateY(0)}}@media(max-width:800px){.package-workbench[data-astro-cid-xk5n4466]{grid-template-columns:1fr}.package-tree[data-astro-cid-xk5n4466]{border-right:0;border-bottom:1px solid var(--muted)}.package-preview[data-astro-cid-xk5n4466]{padding:22px}}@media(max-width:560px){.package-tree[data-astro-cid-xk5n4466]{padding:18px 10px}.package-tree[data-astro-cid-xk5n4466] button[data-astro-cid-xk5n4466]{padding:12px 6px}.package-tree[data-astro-cid-xk5n4466] small[data-astro-cid-xk5n4466]{display:none}.package-preview[data-astro-cid-xk5n4466]{padding:18px}.package-preview[data-astro-cid-xk5n4466] pre[data-astro-cid-xk5n4466]{font-size:var(--step-0)}}@media(prefers-reduced-motion:reduce){[data-astro-cid-xk5n4466],[data-astro-cid-xk5n4466]:before,[data-astro-cid-xk5n4466]:after{scroll-behavior:auto!important;animation-duration:.01ms!important;animation-iteration-count:1!important;transition-duration:.01ms!important}}
.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) monospace;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) monospace;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)}}
<!DOCTYPE html><html lang="en"> <head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>AI For Dummies — Skills</title><meta name="description" content="A skill changes behavior. Keep the trigger precise, put the workflow in SKILL.md, and move conditional facts, scripts, and examples into focused files."><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>.package-workbench[data-astro-cid-xk5n4466]{display:grid;grid-template-columns:minmax(190px,.85fr) minmax(0,1.3fr);min-width:0;background:var(--ink);border:1px solid var(--ink);box-shadow:10px 10px color-mix(in srgb,var(--gold) 55%,transparent)}.package-tree[data-astro-cid-xk5n4466]{padding:22px 16px;border-right:1px solid var(--muted);min-width:0}.package-tree[data-astro-cid-xk5n4466]>p[data-astro-cid-xk5n4466],.package-preview[data-astro-cid-xk5n4466]>span[data-astro-cid-xk5n4466]{margin:0 0 14px;color:var(--gold);font:700 var(--step-0) / 1.35 var(--font-mono);letter-spacing:.1em}.package-tree[data-astro-cid-xk5n4466] button[data-astro-cid-xk5n4466]{display:grid;grid-template-columns:minmax(0,1fr) auto;align-items:center;gap:8px;width:100%;padding:12px 8px;border:0;border-left:2px solid transparent;background:transparent;color:var(--line);text-align:left;cursor:pointer;transition:background .2s ease,border-color .2s ease,transform .2s ease}.package-tree[data-astro-cid-xk5n4466] button[data-astro-cid-xk5n4466]:hover,.package-tree[data-astro-cid-xk5n4466] button[data-astro-cid-xk5n4466]:focus-visible,.package-tree[data-astro-cid-xk5n4466] button[data-astro-cid-xk5n4466].active{border-left-color:var(--gold);background:var(--blue);outline:0}.package-tree[data-astro-cid-xk5n4466] button[data-astro-cid-xk5n4466]:hover{transform:translate(3px)}.package-tree[data-astro-cid-xk5n4466] code[data-astro-cid-xk5n4466]{min-width:0;overflow-wrap:anywhere;font:700 var(--step-13) / 1.4 var(--font-mono)}.package-tree[data-astro-cid-xk5n4466] small[data-astro-cid-xk5n4466]{color:var(--muted);font:var(--step-0) / 1.25 var(--font-sans);text-align:right}.package-preview[data-astro-cid-xk5n4466]{min-width:0;padding:26px;background:var(--ink);color:var(--paper)}.package-preview[data-astro-cid-xk5n4466] h3[data-astro-cid-xk5n4466]{margin:0 0 8px;font-size:clamp(24px,3vw,38px);line-height:1.02;letter-spacing:-.045em}.package-preview[data-astro-cid-xk5n4466] p[data-astro-cid-xk5n4466]{max-width:52ch;margin:0;color:var(--line)}.package-preview[data-astro-cid-xk5n4466] pre[data-astro-cid-xk5n4466]{max-width:100%;margin:20px 0 0;padding:15px;overflow:auto;border:1px solid var(--muted);background:var(--deep);color:var(--line);font:var(--step-12) / 1.55 var(--font-mono)}.package-preview[data-astro-cid-xk5n4466].is-swapping{animation:package-preview-in .2s cubic-bezier(.2,0,0,1) both}@keyframes package-preview-in{0%{opacity:.25;transform:translateY(7px)}to{opacity:1;transform:translateY(0)}}@media(max-width:800px){.package-workbench[data-astro-cid-xk5n4466]{grid-template-columns:1fr}.package-tree[data-astro-cid-xk5n4466]{border-right:0;border-bottom:1px solid var(--muted)}.package-preview[data-astro-cid-xk5n4466]{padding:22px}}@media(max-width:560px){.package-tree[data-astro-cid-xk5n4466]{padding:18px 10px}.package-tree[data-astro-cid-xk5n4466] button[data-astro-cid-xk5n4466]{padding:12px 6px}.package-tree[data-astro-cid-xk5n4466] small[data-astro-cid-xk5n4466]{display:none}.package-preview[data-astro-cid-xk5n4466]{padding:18px}.package-preview[data-astro-cid-xk5n4466] pre[data-astro-cid-xk5n4466]{font-size:var(--step-0)}}@media(prefers-reduced-motion:reduce){[data-astro-cid-xk5n4466],[data-astro-cid-xk5n4466]:before,[data-astro-cid-xk5n4466]:after{scroll-behavior:auto!important;animation-duration:.01ms!important;animation-iteration-count:1!important;transition-duration:.01ms!important}}
.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>03 / SKILLS</span></div> <div class="cell" data-astro-cid-xattfbdu><a href="/ai-for-dummies/skills-review/">review desk ↗</a></div> </header> <main> <section class="hero" data-astro-cid-7xzskqga> <p data-astro-cid-4yr5atew="true" class="eyebrow tone-red">Reusable judgment</p> <h1 data-astro-cid-7xzskqga><span>Teach the<br><em>decision.</em></span></h1> <div class="intro" data-astro-cid-7xzskqga> <p>A skill changes behavior. Keep the trigger precise, put the workflow in <code>SKILL.md</code>, and move conditional facts, scripts, and examples into focused files.</p> </div> </section> <section class="pipeline package-anatomy"> <div> <p class="eyebrow">Package anatomy</p> <h2>One job.<br>More than<br>one <em>file.</em></h2> <p class="package-hint">Choose a file to see why it belongs in the package.</p> </div> <div class="package-workbench" data-package-workbench data-astro-cid-xk5n4466> <div class="package-tree" role="tablist" aria-label="Files in the review-ui skill package" data-astro-cid-xk5n4466> <p data-astro-cid-xk5n4466>REVIEW-UI / SKILL PACKAGE</p> <button class="active" data-skill-file="skill" role="tab" aria-selected="true" data-astro-cid-xk5n4466> <code data-astro-cid-xk5n4466>├── SKILL.md</code> <small data-astro-cid-xk5n4466>trigger + workflow</small> </button><button data-skill-file="references" role="tab" aria-selected="false" data-astro-cid-xk5n4466> <code data-astro-cid-xk5n4466>├── references/</code> <small data-astro-cid-xk5n4466>conditional facts</small> </button><button data-skill-file="scripts" role="tab" aria-selected="false" data-astro-cid-xk5n4466> <code data-astro-cid-xk5n4466>├── scripts/</code> <small data-astro-cid-xk5n4466>deterministic checks</small> </button><button data-skill-file="assets" role="tab" aria-selected="false" data-astro-cid-xk5n4466> <code data-astro-cid-xk5n4466>└── assets/</code> <small data-astro-cid-xk5n4466>templates + examples</small> </button> </div> <article class="package-preview" id="package-preview" aria-live="polite" data-astro-cid-xk5n4466></article> </div> <script type="application/json" data-skill-files>[{"id":"skill","prefix":"├── ","label":"SKILL.md","caption":"trigger + workflow","title":"The operating contract","body":"The one file that should always be loaded. Define the exact trigger, the ordered workflow, safety limits, and the evidence the agent returns.","code":"---\nname: review-ui\ndescription: Review a changed UI for focus, reflow, and motion.\n---\n\n1. Inspect the changed interaction.\n2. Run the UI checks.\n3. Return findings with evidence."},{"id":"references","prefix":"├── ","label":"references/","caption":"conditional facts","title":"Facts, only when needed","body":"Keep conditional detail out of the main instruction. A dialog pattern, framework caveat, or accessibility checklist belongs here when it is not needed for every review.","code":"references/\n└── accessibility.md\n ├── keyboard interaction patterns\n └── focus and reflow checklist"},{"id":"scripts","prefix":"├── ","label":"scripts/","caption":"deterministic checks","title":"Mechanics that should not depend on memory","body":"Turn deterministic checks into runnable tools. The agent still judges the result, but it should not have to recreate a viewport test or filename rule by hand.","code":"scripts/\n└── check-reflow.mjs\n └── checks 320px, 1280px, and 4K widths"},{"id":"assets","prefix":"└── ","label":"assets/","caption":"templates + examples","title":"Starting material, not hidden instructions","body":"Use assets for templates and examples a person or agent can copy. Keep them clearly named so package readers can choose the right starting point.","code":"assets/\n├── review-report.md\n└── focus-test-fixture.html"}]</script> <script>
(function () {
const preview = document.querySelector('#package-preview');
+2 -2
View File
@@ -1,5 +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 — Route map</title><meta name="description" content><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/chapters.Bvwgp4pJ.css"><style>.grid[data-astro-cid-wrac2jwd]{display:grid;grid-template-columns:repeat(var(--columns),1fr);gap:1px;background:var(--line);border:1px solid var(--line);margin-bottom:100px}.grid[data-astro-cid-wrac2jwd]>.card{min-height:220px;padding:28px;background:var(--paper)}.grid[data-astro-cid-wrac2jwd]>.card b{color:var(--red);font-size:clamp(24px,24px,24px);font-family:ui-monospace,monospace}.grid[data-astro-cid-wrac2jwd]>.card h2{margin:18px 0 8px;font-size:clamp(25px,25px,25px);letter-spacing:-.04em}.grid[data-astro-cid-wrac2jwd]>.card p{margin:0 0 14px;color:var(--muted)}.grid[data-astro-cid-wrac2jwd]>.card a{color:var(--blue);font-weight:700}@media(max-width:800px){.grid[data-astro-cid-wrac2jwd]{grid-template-columns:1fr}}@media(max-width:560px){.grid[data-astro-cid-wrac2jwd]>.card{min-height:0}}
.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) monospace;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) monospace;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)}}
<!DOCTYPE html><html lang="en"> <head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>AI For Dummies — Route map</title><meta name="description" content><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>.grid[data-astro-cid-wrac2jwd]{display:grid;grid-template-columns:repeat(var(--columns),1fr);gap:1px;background:var(--line);border:1px solid var(--line);margin-bottom:100px}.grid[data-astro-cid-wrac2jwd]>.card{min-height:220px;padding:28px;background:var(--paper)}.grid[data-astro-cid-wrac2jwd]>.card b{color:var(--red);font-size:clamp(24px,24px,24px);font-family:ui-monospace,monospace}.grid[data-astro-cid-wrac2jwd]>.card h2{margin:18px 0 8px;font-size:clamp(25px,25px,25px);letter-spacing:-.04em}.grid[data-astro-cid-wrac2jwd]>.card p{margin:0 0 14px;color:var(--muted)}.grid[data-astro-cid-wrac2jwd]>.card a{color:var(--blue);font-weight:700}@media(max-width:800px){.grid[data-astro-cid-wrac2jwd]{grid-template-columns:1fr}}@media(max-width:560px){.grid[data-astro-cid-wrac2jwd]>.card{min-height:0}}
.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/full-guide/">← AI FOR DUMMIES</a></div> <div class="cell" data-astro-cid-xattfbdu><span>00 / ROUTE MAP</span></div> <div class="cell" data-astro-cid-xattfbdu><a href="/ai-for-dummies/skills-review/">review desk ↗</a></div> </header> <main> <section class="hero" data-astro-cid-7xzskqga> <p data-astro-cid-4yr5atew="true" class="eyebrow tone-red">Start here</p> <h1 data-astro-cid-7xzskqga><span>Ship the<br><em>system.</em></span></h1> <div class="intro" data-astro-cid-7xzskqga> <p>This guide turns AI work into a shape: frame the problem, choose the model and agent, isolate changes, teach repeatable decisions, and verify the result.</p> </div> </section> <section class="grid" style="--columns: 3" data-astro-cid-wrac2jwd> <article class="card"> <b>01</b><h2>Models</h2><p>Capability and effort are separate knobs.</p><a href="/ai-for-dummies/models/">Open chapter →</a> </article> <article class="card"> <b>02</b><h2>Agents & trees</h2><p>Bound roles, handoffs, and worktrees.</p><a href="/ai-for-dummies/agents/">Open chapter →</a> </article> <article class="card"> <b>03</b><h2>Skills</h2><p>Capture repeatable decisions.</p><a href="/ai-for-dummies/skills/">Open chapter →</a> </article> <article class="card"> <b>04</b><h2>Rules</h2><p>Connect guidance to enforcement.</p><a href="/ai-for-dummies/rules/">Open chapter →</a> </article> <article class="card"> <b>05</b><h2>Practice</h2><p>Compare prompts and skill-enabled runs.</p><a href="/ai-for-dummies/hands-on/starter/">Open lab →</a> </article> <article class="card"> <b>06</b><h2>Review desk</h2><p>Browse original files and improved drafts.</p><a href="/ai-for-dummies/skills-review/">Open desk →</a> </article> </section> </main> <section class="footer" data-astro-cid-bmvnf73n> <nav class="links" aria-label="Chapter navigation" data-astro-cid-bmvnf73n> <a href="/ai-for-dummies/full-guide/">Full field guide</a><a href="/ai-for-dummies/docs/operations-guide.md">Operations guide</a> </nav> <div class="text" data-astro-cid-bmvnf73n> <span>
Each chapter stands alone; the order follows a real task becoming a reliable change.
</span> </div> </section> </body></html>