revert: drop the out-of-scope reformat from the localization commit
The localization pass ran prettier across the repository rather than the files it owns. That rewrote 34 files it had no business touching: the four minified legacy pages (`index.html`, `agents/`, `models/`, `summary/`), `scripts/verify.mjs`, `GATES.md`, `docs/references/`, and most of `.agents/`. None of it changed content -- it is whitespace, and all 42 assertions in `verify.mjs` survived intact. It is still wrong here. The legacy HTML is minified deliberately, `verify.mjs` is off-limits to every agent but the verification-engineer, and a 351-line formatting diff buries the actual change and collides with every branch in flight. Keeps only what task 15d owns: `src/pages/full-guide.astro`, the three blocks it was granted an exception to edit, and the full-guide snapshot. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Marcos Paulo
+1
-88
@@ -1,88 +1 @@
|
||||
<!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>
|
||||
<link rel="stylesheet" href="../chapters.css" />
|
||||
</head>
|
||||
<body>
|
||||
<main>
|
||||
<header class="top">
|
||||
<a href="../summary/">← ROUTE MAP</a><span>02 / AGENTS & TREES</span
|
||||
><a href="../full-guide/">field guide ↗</a>
|
||||
</header>
|
||||
<section class="hero">
|
||||
<p class="eyebrow">Subagent workflow</p>
|
||||
<h1>One branch<br />per <em>hand.</em></h1>
|
||||
<p>
|
||||
Agents work when roles, files, and evidence are bounded. A worktree gives each worker its
|
||||
own checkout while the orchestrator protects intent.
|
||||
</p>
|
||||
</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>
|
||||
<nav class="links">
|
||||
<a href="../models/">Previous: models →</a><a href="../rules/">Rules case study →</a
|
||||
><a href="../hands-on/rules/">Try the rules lab →</a>
|
||||
</nav>
|
||||
</main>
|
||||
</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><link rel="stylesheet" href="../chapters.css"></head><body><main><header class="top"><a href="../summary/">← ROUTE MAP</a><span>02 / AGENTS & TREES</span><a href="../full-guide/">field guide ↗</a></header><section class="hero"><p class="eyebrow">Subagent workflow</p><h1>One branch<br>per <em>hand.</em></h1><p>Agents work when roles, files, and evidence are bounded. A worktree gives each worker its own checkout while the orchestrator protects intent.</p></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><nav class="links"><a href="../models/">Previous: models →</a><a href="../rules/">Rules case study →</a><a href="../hands-on/rules/">Try the rules lab →</a></nav></main></body></html>
|
||||
|
||||
+24
-76
@@ -1,79 +1,27 @@
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<meta name="viewport" content="width=device-width,initial-scale=1" />
|
||||
<meta
|
||||
name="description"
|
||||
content="AI For Dummies: a practical route map for models, agents, worktrees, skills, rules, and verification."
|
||||
/>
|
||||
<title>AI For Dummies — Start here</title>
|
||||
<link rel="stylesheet" href="chapters.css" />
|
||||
<link rel="stylesheet" href="landing.css" />
|
||||
</head>
|
||||
<body>
|
||||
<main>
|
||||
<header class="top">
|
||||
<a href="./" aria-current="page">AI FOR DUMMIES</a><span>00 / START HERE</span
|
||||
><a href="skills-review/">review desk ↗</a>
|
||||
</header>
|
||||
<section class="hero">
|
||||
<p class="eyebrow">The short route</p>
|
||||
<h1>Ship the<br /><em>system.</em></h1>
|
||||
<p>
|
||||
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>
|
||||
<a class="guide-launch" href="full-guide/">Take the full field guide <span>→</span></a>
|
||||
</section>
|
||||
<section class="grid route-grid" aria-label="Guide chapters">
|
||||
<article class="card">
|
||||
<b>01</b>
|
||||
<h2>Models</h2>
|
||||
<p>Capability and effort are separate knobs.</p>
|
||||
<a href="models/">Open chapter →</a>
|
||||
</article>
|
||||
<article class="card">
|
||||
<b>02</b>
|
||||
<h2>Agents & trees</h2>
|
||||
<p>Bound roles, handoffs, and worktrees.</p>
|
||||
<a href="agents/">Open chapter →</a>
|
||||
</article>
|
||||
<article class="card">
|
||||
<b>03</b>
|
||||
<h2>Skills</h2>
|
||||
<p>Capture repeatable decisions in small packages.</p>
|
||||
<a href="skills/">Open chapter →</a>
|
||||
</article>
|
||||
<article class="card">
|
||||
<b>04</b>
|
||||
<h2>Rules</h2>
|
||||
<p>Connect guidance to enforcement.</p>
|
||||
<a href="rules/">Open chapter →</a>
|
||||
</article>
|
||||
<article class="card">
|
||||
<b>05</b>
|
||||
<h2>Hands-on</h2>
|
||||
<p>Compare a strong prompt with skill-enabled work.</p>
|
||||
<a href="hands-on/starter/">Open lab →</a>
|
||||
</article>
|
||||
<article class="card">
|
||||
<b>06</b>
|
||||
<h2>Review desk</h2>
|
||||
<p>Browse original packages, references, scripts, and improvements.</p>
|
||||
<a href="skills-review/">Open desk →</a>
|
||||
</article>
|
||||
</section>
|
||||
<section class="landing-note">
|
||||
<span>THE THREAD</span
|
||||
><strong
|
||||
>Frame uncertainty → isolate execution → preserve judgment → verify the change.</strong
|
||||
>
|
||||
</section>
|
||||
<footer>
|
||||
The route map is now the default entry. The full guide remains available whenever you want
|
||||
the whole narrative.
|
||||
</footer>
|
||||
</main>
|
||||
</body>
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width,initial-scale=1">
|
||||
<meta name="description" content="AI For Dummies: a practical route map for models, agents, worktrees, skills, rules, and verification.">
|
||||
<title>AI For Dummies — Start here</title>
|
||||
<link rel="stylesheet" href="chapters.css">
|
||||
<link rel="stylesheet" href="landing.css">
|
||||
</head>
|
||||
<body>
|
||||
<main>
|
||||
<header class="top"><a href="./" aria-current="page">AI FOR DUMMIES</a><span>00 / START HERE</span><a href="skills-review/">review desk ↗</a></header>
|
||||
<section class="hero"><p class="eyebrow">The short route</p><h1>Ship the<br><em>system.</em></h1><p>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><a class="guide-launch" href="full-guide/">Take the full field guide <span>→</span></a></section>
|
||||
<section class="grid route-grid" aria-label="Guide chapters">
|
||||
<article class="card"><b>01</b><h2>Models</h2><p>Capability and effort are separate knobs.</p><a href="models/">Open chapter →</a></article>
|
||||
<article class="card"><b>02</b><h2>Agents & trees</h2><p>Bound roles, handoffs, and worktrees.</p><a href="agents/">Open chapter →</a></article>
|
||||
<article class="card"><b>03</b><h2>Skills</h2><p>Capture repeatable decisions in small packages.</p><a href="skills/">Open chapter →</a></article>
|
||||
<article class="card"><b>04</b><h2>Rules</h2><p>Connect guidance to enforcement.</p><a href="rules/">Open chapter →</a></article>
|
||||
<article class="card"><b>05</b><h2>Hands-on</h2><p>Compare a strong prompt with skill-enabled work.</p><a href="hands-on/starter/">Open lab →</a></article>
|
||||
<article class="card"><b>06</b><h2>Review desk</h2><p>Browse original packages, references, scripts, and improvements.</p><a href="skills-review/">Open desk →</a></article>
|
||||
</section>
|
||||
<section class="landing-note"><span>THE THREAD</span><strong>Frame uncertainty → isolate execution → preserve judgment → verify the change.</strong></section>
|
||||
<footer>The route map is now the default entry. The full guide remains available whenever you want the whole narrative.</footer>
|
||||
</main>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
+1
-87
@@ -1,87 +1 @@
|
||||
<!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>
|
||||
<link rel="stylesheet" href="../chapters.css" />
|
||||
</head>
|
||||
<body>
|
||||
<main>
|
||||
<header class="top">
|
||||
<a href="../summary/">← ROUTE MAP</a><span>01 / MODELS</span
|
||||
><a href="../full-guide/">field guide ↗</a>
|
||||
</header>
|
||||
<section class="hero">
|
||||
<p class="eyebrow">Model routing</p>
|
||||
<h1>Choose the<br /><em>engine.</em></h1>
|
||||
<p>
|
||||
A model has a capability ceiling. Effort controls how much room it gets to reason. Route
|
||||
by uncertainty and verification cost.
|
||||
</p>
|
||||
</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>
|
||||
<nav class="links">
|
||||
<a href="../agents/">Next: agents & trees →</a><a href="../rules/">Rules case study →</a>
|
||||
</nav>
|
||||
</main>
|
||||
</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><link rel="stylesheet" href="../chapters.css"></head><body><main><header class="top"><a href="../summary/">← ROUTE MAP</a><span>01 / MODELS</span><a href="../full-guide/">field guide ↗</a></header><section class="hero"><p class="eyebrow">Model routing</p><h1>Choose the<br><em>engine.</em></h1><p>A model has a capability ceiling. Effort controls how much room it gets to reason. Route by uncertainty and verification cost.</p></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><nav class="links"><a href="../agents/">Next: agents & trees →</a><a href="../rules/">Rules case study →</a></nav></main></body></html>
|
||||
|
||||
+1
-70
@@ -1,70 +1 @@
|
||||
<!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>
|
||||
<link rel="stylesheet" href="../chapters.css" />
|
||||
</head>
|
||||
<body>
|
||||
<main>
|
||||
<header class="top">
|
||||
<a href="../full-guide/">← AI FOR DUMMIES</a><span>00 / ROUTE MAP</span
|
||||
><a href="../skills-review/">review desk ↗</a>
|
||||
</header>
|
||||
<section class="hero">
|
||||
<p class="eyebrow">Start here</p>
|
||||
<h1>Ship the<br /><em>system.</em></h1>
|
||||
<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>
|
||||
</section>
|
||||
<section class="grid">
|
||||
<article class="card">
|
||||
<b>01</b>
|
||||
<h2>Models</h2>
|
||||
<p>Capability and effort are separate knobs.</p>
|
||||
<a href="../models/">Open chapter →</a>
|
||||
</article>
|
||||
<article class="card">
|
||||
<b>02</b>
|
||||
<h2>Agents & trees</h2>
|
||||
<p>Bound roles, handoffs, and worktrees.</p>
|
||||
<a href="../agents/">Open chapter →</a>
|
||||
</article>
|
||||
<article class="card">
|
||||
<b>03</b>
|
||||
<h2>Skills</h2>
|
||||
<p>Capture repeatable decisions.</p>
|
||||
<a href="../skills/">Open chapter →</a>
|
||||
</article>
|
||||
<article class="card">
|
||||
<b>04</b>
|
||||
<h2>Rules</h2>
|
||||
<p>Connect guidance to enforcement.</p>
|
||||
<a href="../rules/">Open chapter →</a>
|
||||
</article>
|
||||
<article class="card">
|
||||
<b>05</b>
|
||||
<h2>Practice</h2>
|
||||
<p>Compare prompts and skill-enabled runs.</p>
|
||||
<a href="../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="../skills-review/">Open desk →</a>
|
||||
</article>
|
||||
</section>
|
||||
<nav class="links">
|
||||
<a href="../full-guide/">Full field guide</a
|
||||
><a href="../docs/operations-guide.md">Operations guide</a>
|
||||
</nav>
|
||||
<footer>
|
||||
Each chapter stands alone; the order follows a real task becoming a reliable change.
|
||||
</footer>
|
||||
</main>
|
||||
</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 — Route map</title><link rel="stylesheet" href="../chapters.css"></head><body><main><header class="top"><a href="../full-guide/">← AI FOR DUMMIES</a><span>00 / ROUTE MAP</span><a href="../skills-review/">review desk ↗</a></header><section class="hero"><p class="eyebrow">Start here</p><h1>Ship the<br><em>system.</em></h1><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></section><section class="grid"><article class="card"><b>01</b><h2>Models</h2><p>Capability and effort are separate knobs.</p><a href="../models/">Open chapter →</a></article><article class="card"><b>02</b><h2>Agents & trees</h2><p>Bound roles, handoffs, and worktrees.</p><a href="../agents/">Open chapter →</a></article><article class="card"><b>03</b><h2>Skills</h2><p>Capture repeatable decisions.</p><a href="../skills/">Open chapter →</a></article><article class="card"><b>04</b><h2>Rules</h2><p>Connect guidance to enforcement.</p><a href="../rules/">Open chapter →</a></article><article class="card"><b>05</b><h2>Practice</h2><p>Compare prompts and skill-enabled runs.</p><a href="../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="../skills-review/">Open desk →</a></article></section><nav class="links"><a href="../full-guide/">Full field guide</a><a href="../docs/operations-guide.md">Operations guide</a></nav><footer>Each chapter stands alone; the order follows a real task becoming a reliable change.</footer></main></body></html>
|
||||
|
||||
Reference in New Issue
Block a user