chore: take vote-service out of the repository root

Removes the Go source, Dockerfile, go.mod, and Kubernetes manifests. The deployed service is untouched and the review desk still calls it over window.SKILLS_REVIEW_VOTE_API; only the source leaves. The runbook does not leave. vote-service/README.md moves to docs/vote-service.md, because it carries the parts that are hard to rediscover: why the ingress overwrites X-Forwarded-For and Caddy stamps X-Client-IP instead, why the image is side-loaded into containerd rather than pulled, and why the PVC pins the Deployment to one node. This drops verify.mjs from 84 assertions to 83. The removed one read vote-service/main.go for X-Forwarded-For and 'one active vote per skill' -- the review desk's only anti-abuse control -- and there is no file left to read. It is the first assertion this repository has ever lost. Rather than lower the gate's floor and leave a bare number behind, gate.sh now subtracts the number of entries in .agents/context/assertion-removals.md from the baseline. A removal costs a written reason in a tracked file, in the same commit, as a visible diff. Tested at 82 assertions: still refused. Also drops the 22 MB of PNG baselines under .agents/snapshots/before/ and before-reduced-motion/. They pictured the hand-written site, which no longer exists; visual-regression.mjs has no compare mode to diff them against; and they are recoverable from d88d8b8. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
refactor: cut over to the Astro build
2026-09-06 08:59:45 +00:00 · 2026-09-06 08:31:33 +00:00 · 2026-09-06 08:31:20 +00:00 · 2026-09-06 08:30:27 +00:00 · 2026-09-06 08:16:13 +00:00 · 2026-09-06 03:48:57 +00:00
153 changed files with 2774 additions and 1799 deletions
@@ -1,45 +1,47 @@
-# Context: architecture, current and target
+# Context: architecture
-## Current (no build step)
+## Current (Astro, static output)
-Ten hand-written HTML pages, each linking its own CSS and one ES module:
+Ten routes, one `src/pages/` entry each, built to `dist/`:
-| Route                | Page                       | Script                 | Stylesheets                                   |
+| Route                | Page                            | Islands                                         |
-| -------------------- | -------------------------- | ---------------------- | --------------------------------------------- |
+| -------------------- | ------------------------------- | ----------------------------------------------- |
-| `/`                  | `index.html`               | —                      | `chapters.css`, `landing.css`                 |
+| `/`                  | `src/pages/index.astro`         | —                                               |
-| `/full-guide/`       | `full-guide/index.html`    | `app.js` (50 KB)       | `styles.css`, `responsive.css`, `audit.css`   |
+| `/full-guide/`       | `src/pages/full-guide.astro`    | `GuideSelector`, `LanguageToggle`, `CopyPrompt` |
-| `/summary/`          | `summary/index.html`       | —                      | `chapters.css`                                |
+| `/summary/`          | `src/pages/summary.astro`       | —                                               |
-| `/models/`           | `models/index.html`        | —                      | `chapters.css`                                |
+| `/models/`           | `src/pages/models.astro`        | —                                               |
-| `/agents/`           | `agents/index.html`        | —                      | `chapters.css`                                |
+| `/agents/`           | `src/pages/agents.astro`        | —                                               |
-| `/skills/`           | `skills/index.html`        | `skills/app.js`        | `skills/styles.css`                           |
+| `/skills/`           | `src/pages/skills.astro`        | `SkillPackageExplorer`                          |
-| `/rules/`            | `rules/index.html`         | `rules/app.js`         | `rules/styles.css`                            |
+| `/rules/`            | `src/pages/rules.astro`         | `RulesInteractive`                              |
-| `/skills-review/`    | `skills-review/index.html` | `skills-review/app.js` | `skills-review/styles.css`, `change-lens.css` |
+| `/skills-review/`    | `src/pages/skills-review.astro` | `legacy/skills-review/app.js`                   |
-| `/hands-on/starter/` | lab fixture                | own                    | own                                           |
+| `/hands-on/starter/` | `public/` lab fixture           | own                                             |
-| `/hands-on/rules/`   | lab fixture                | own                    | own                                           |
+| `/hands-on/rules/`   | `public/` lab fixture           | own                                             |
-Weight is concentrated: `app.js` 50 KB, `responsive.css` 30 KB,
+## What is still unmigrated
 `skills-review/catalog.js` 27 KB, `skills-review/submitted-catalog.js` 18 KB.
-### What each big file actually is
+`legacy/` holds the parts the migration did not componentize. They are not dead
 files — the pages listed above import them, and the build fails without them.
- **`app.js`** — not really application code. It is a **bilingual content
+- **`legacy/styles/guide.css`** (was `styles.css`) — the editorial visual
-  database** (`phases`, `handsOnPrompts`, `modelGuide`, `skillSources`,
+  system, imported by `full-guide.astro`.
-  `skillInstallPrompts`, each keyed `{en, pt}`) plus ~12 small `render*`
+- **`legacy/styles/audit.css`** (was `full-guide/audit.css`) — responsive audit
-  functions that swap `innerHTML` on tab clicks. ~50 `en:` keys. The content
+  overrides, imported by `full-guide.astro`.
-  should become data; only the tab behaviour is interactive.
+- **`legacy/styles/chapters.css`** — imported by `ChapterLayout.astro`.
- **`responsive.css`** — a 30 KB append-only layer of overrides bolted on top of
+- **`legacy/styles/skills.css`**, **`skills-review.css`**, **`change-lens.css`**
-  `styles.css`. Expect large parts to be dead once layout moves into components.
+  — imported by their respective pages.
-  Do not port it verbatim.
+- **`legacy/skills-review/`** — `app.js` and the module graph under it
- **`skills-review/catalog.js`** — the real data model of the review desk: one
+  (`catalog.js`, `submitted-catalog.js`, `files.js`, `submitted-files.js`,
-  entry per submitted skill with `id`, `author`, `title`, `status`, `focus`,
+  `vote.js`). `catalog.js` + `submitted-catalog.js` are the review desk's real
-  `wins[]`, `improve[]`, `extras`, `improved` (full markdown). 24 entries across
+  data model, 24 entries; they are a content collection in all but name.
  `catalog.js` + `submitted-catalog.js`. This is already a content collection in
  all but name.
 - **`skills-review/files.js` / `submitted-files.js`** — generated file
  manifests.
 - **`vote.js`** — the vote widget island; talks to `vote-service/`.
-## Target (Astro)
+These sit outside `src/` deliberately: `check-tokens.mjs` sweeps `src`, and
 these files are full of raw hex and unnamed breakpoints. Moving one into `src/`
 means migrating it to tokens in the same change, not adding an exclusion.
 `responsive.css`, `landing.css`, `app.js`, `rules/app.js`, `rules/styles.css`,
 and `skills/app.js` were deleted at cutover: their content lives in components.
 ## Layout
 ```
 src/
@@ -52,15 +54,15 @@ public/
  hands-on/           lab fixtures copied verbatim, never processed
 ```
-### Non-negotiables for the target
+### Non-negotiables
 - **URLs do not change.** `/full-guide/`, `/skills-review/`,
  `/hands-on/starter/` and the rest must resolve exactly as they do now,
  trailing slash included. Existing links (including `docs/`, SilverBullet, and
  shared URLs with `?author=…&skill=…&view=…` query params) must keep working.
- **Zero JS by default.** Seven of the ten pages ship no JavaScript today. They
+- **Zero JS by default.** Seven of the ten pages ship no JavaScript. They must
-  must still ship none. Islands are opt-in, per component, and justified.
+  still ship none. Islands are opt-in, per component, and justified.
- **`hands-on/` stays vanilla.** It goes in `public/` untouched. It is a lab
+- **`hands-on/` stays vanilla.** It lives in `public/` untouched. It is a lab
  fixture, not a component.
 - **No external runtime requests.** `audit-ui.mjs` enforces this and it is part
  of the site's thesis. Self-host anything you add.
@@ -70,7 +72,12 @@ public/
 ## Companion service
-`vote-service/` is a Go API on its own Kubernetes deploy cycle, reached by the
+The vote API is a Go service on its own Kubernetes deploy cycle, reached by the
-review desk over `window.SKILLS_REVIEW_VOTE_API`. The refactor does not touch
+review desk over `window.SKILLS_REVIEW_VOTE_API`. Its source left this
-it. Keep the global, or replace it with a build-time `PUBLIC_VOTE_API` env var —
+repository on 2026-09-06; the deployed service is unchanged, and the review desk
-but if you do, update `vote-service/README.md` in the same change.
+still calls it. Keep the global, or replace it with a build-time
 `PUBLIC_VOTE_API` env var — but if you do, update the service's own README in
 the same change.
 Its one-vote-per-IP assertion left `verify.mjs` with it. See
 [`assertion-removals.md`](assertion-removals.md).
@@ -0,0 +1,26 @@
 # Assertion removal ledger
 `scripts/verify.mjs` may only lose an assertion by adding an entry here. The
 gate counts the `## ` headings in this file and allows exactly that many
 removals below the recorded floor — so a reduction is impossible without a
 written reason landing in the same commit, as a visible diff.
 Adding an entry is not a formality. An assertion pins a real contract; removing
 one means that contract is now unverified. Say where it moved, or say plainly
 that nothing checks it any more.
 ## vote-service one-vote-per-IP contract
 **Removed:** 2026-09-06, when `vote-service/` was taken out of this repository.
 **What it asserted:** that `vote-service/main.go` contained both
 `X-Forwarded-For` and `one active vote per skill` — the review desk's only
 anti-abuse control, one vote per visitor enforced server-side by source IP.
 **Why it went:** there is no file left to read. The check was a substring match
 against source that now lives elsewhere.
 **Where it must be re-asserted:** in whichever repository holds the service. The
 deployed service still enforces the contract; nothing in this repository proves
 it. If `vote-service/` ever comes back here, restore the assertion and delete
 this entry.
@@ -19,7 +19,7 @@ Only these need interactivity. Anything else claiming island status is wrong:
 | --------------------------------- | ---------------------------------- | ---------------- |
 | Guide phase/tab switchers         | click-driven panel swap            | `client:visible` |
 | Review desk catalog + file viewer | search, filter, fetch source files | `client:load`    |
-| Vote widget                       | talks to `vote-service/`           | `client:visible` |
+| Vote widget                       | talks to the vote API              | `client:visible` |
 | Language toggle                   | swaps EN/PT across the page        | `client:idle`    |
 ## Structure
@@ -0,0 +1,173 @@
 #!/usr/bin/env node
 // Compare the *computed* styles of a legacy page against its Astro
 // replacement, at several viewport widths.
 //
 //   node .agents/scripts/computed-style-diff.mjs full-guide
 //   node .agents/scripts/computed-style-diff.mjs full-guide --widths 560,880,1050
 //
 // Why this exists: a ported media query can sit in the built stylesheet,
 // match the viewport, and still do nothing. Astro scopes a component's rules
 // as `.tree-node[data-astro-cid-lsutp3lb]` (specificity 0,2,0); a rule ported
 // verbatim as `.tree-node` (0,1,0) loses to it and never applies. Task 15e
 // attempt 4 shipped exactly that: `@media (max-width: 1050px) .tree-node
 // { width: 145px }` was present in dist and the node stayed 180px wide.
 //
 // Checking that the breakpoint *appears* in the built CSS cannot catch this.
 // Only asking the browser what it actually computed can.
 import { spawn } from 'node:child_process';
 import { cpSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
 import { createServer } from 'node:net';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { chromium } from 'playwright';
 const route = process.argv[2];
 if (!route) {
  console.error('usage: computed-style-diff.mjs <route> [--widths a,b,c]');
  process.exit(2);
 }
 const widthsArg = process.argv.indexOf('--widths');
 const widths =
  widthsArg === -1
    ? [520, 560, 600, 620, 720, 800, 880, 1050, 1100, 1600]
    : process.argv[widthsArg + 1].split(',').map(Number);
 // The selectors worth checking are the ones the responsive layer moves at a
 // breakpoint, so read them out of the legacy stylesheet's @media blocks only.
 // Taking every class in the file buries the signal under generic ones like
 // `.active`, whose state the islands own anyway.
 const responsive = readFileSync(new URL('../../responsive.css', import.meta.url), 'utf8');
 const mediaBlocks = [];
 for (const match of responsive.matchAll(/@media[^{]*\{/g)) {
  let depth = 0;
  for (let i = match.index; i < responsive.length; i += 1) {
    if (responsive[i] === '{') depth += 1;
    else if (responsive[i] === '}') {
      depth -= 1;
      if (depth === 0) {
        mediaBlocks.push(responsive.slice(match.index + match[0].length, i));
        break;
      }
    }
  }
 }
 const selectors = [...new Set(mediaBlocks.join('\n').match(/\.[a-z][a-z0-9-]*/g) || [])].sort();
 // Properties a responsive rule actually moves. Comparing every property would
 // drown the signal in font stacks and inherited colour.
 const PROPERTIES = [
  'display',
  'grid-template-columns',
  'grid-template-rows',
  'flex-direction',
  'width',
  'height',
  'max-width',
  'padding',
  'margin',
  'gap',
  'font-size',
  'position',
  'inset',
  'overflow',
 ];
 // The legacy pages were deleted at cutover; run this from a pre-cutover
 // worktree, or the legacy side will 404.
 const legacyPath = route === 'index' ? 'index.html' : `${route}/index.html`;
 const astroPath = route === 'index' ? '' : `${route}/`;
 const staging = mkdtempSync(join(tmpdir(), 'af-csd-'));
 cpSync('dist', join(staging, 'ai-for-dummies'), { recursive: true });
 const freePort = () =>
  new Promise((resolve, reject) => {
    const probe = createServer();
    probe.on('error', reject);
    probe.listen(0, '127.0.0.1', () => {
      const { port } = probe.address();
      probe.close(() => resolve(port));
    });
  });
 const legacyPort = await freePort();
 const astroPort = await freePort();
 const serve = (dir, port) =>
  spawn('python3', ['-m', 'http.server', String(port), '-d', dir], { stdio: 'ignore' });
 const servers = [serve('.', legacyPort), serve(staging, astroPort)];
 const stop = () => {
  servers.forEach((s) => s.kill());
  rmSync(staging, { recursive: true, force: true });
 };
 // Every element matching each selector, so a rule that applies to the first
 // node and not the rest cannot pass.
 const collect = ([selectors, properties]) => {
  const out = {};
  for (const selector of selectors) {
    const nodes = [...document.querySelectorAll(selector)];
    out[selector] = nodes.map((node) => {
      const style = getComputedStyle(node);
      return properties
        .map((property) => `${property}:${style.getPropertyValue(property)}`)
        .join(';');
    });
  }
  return out;
 };
 let failures = 0;
 try {
  const browser = await chromium.launch();
  const read = async (url, width) => {
    const page = await browser.newPage({ viewport: { width, height: 900 } });
    const response = await page.goto(url, { waitUntil: 'load' });
    if (!response || !response.ok()) {
      throw new Error(`${url} returned ${response ? response.status() : 'no response'}`);
    }
    await page.waitForTimeout(1500);
    const styles = await page.evaluate(collect, [selectors, PROPERTIES]);
    await page.close();
    return styles;
  };
  for (const width of widths) {
    const legacy = await read(`http://localhost:${legacyPort}/${legacyPath}`, width);
    const astro = await read(`http://localhost:${astroPort}/ai-for-dummies/${astroPath}`, width);
    for (const selector of selectors) {
      const before = legacy[selector];
      const after = astro[selector];
      if (before.length === 0 && after.length === 0) continue;
      if (before.length !== after.length) {
        console.log(
          `${width}px  ${selector}  legacy ${before.length} nodes, astro ${after.length}`,
        );
        failures += 1;
        continue;
      }
      let reported = 0;
      before.forEach((expected, index) => {
        if (expected === after[index]) return;
        failures += 1;
        // Three examples is enough to identify a rule that did not apply.
        reported += 1;
        if (reported > 3) return;
        const differing = expected
          .split(';')
          .filter((pair, i) => pair !== after[index].split(';')[i]);
        const got = after[index].split(';').filter((pair, i) => pair !== expected.split(';')[i]);
        console.log(`${width}px  ${selector}[${index}]`);
        console.log(`   legacy ${differing.join(' ')}`);
        console.log(`   astro  ${got.join(' ')}`);
      });
    }
  }
  await browser.close();
  console.log(failures === 0 ? 'computed styles match' : `${failures} computed-style differences`);
  process.exitCode = failures === 0 ? 0 : 1;
 } finally {
  stop();
 }
@@ -51,11 +51,19 @@ pnpm run verify
 # The assertion count is the thing agents are most tempted to "fix" downward.
 # Compare against origin/main and refuse a silent reduction.
 step "assertion coverage"
 # Task 19 restored the 42 legacy facts and added ten output snapshots: 84 is the
 # floor, in addition to whatever origin/main currently requires.
 #
 # A removal is allowed only by writing a reason into the ledger. The gate counts
 # its entries and lowers the bar by exactly that many, so the bar cannot move
 # without a visible diff explaining why. Deleting an entry to buy headroom is
 # the same offence as deleting the assertion was.
 ledger=.agents/context/assertion-removals.md
 current=$(grep -c 'throw new Error' scripts/verify.mjs)
-# Task 19 restored the 42 legacy facts and added ten output snapshots: 84 is
+allowed=$(grep -c '^## ' "$ledger" 2>/dev/null || echo 0)
 # now the floor, in addition to whatever origin/main currently requires.
 baseline=$(git show origin/main:scripts/verify.mjs 2>/dev/null | grep -c 'throw new Error' || echo 0)
 if [ "$baseline" -lt 84 ]; then baseline=84; fi
 baseline=$((baseline - allowed))
 if [ "$current" -lt "$baseline" ]; then
  echo "gate: verify.mjs coverage fell from $baseline to $current assertions." >&2
  echo "      Only verification-engineer may reduce it, with a reason per removal." >&2
@@ -17,6 +17,10 @@
 // bilingual pair, so the two sides line up.
 //
 // Requires playwright (devDependency) and two static servers; it starts both.
 //
 // The legacy pages were deleted at cutover, so this needs a pre-cutover tree:
 //   git worktree add /tmp/vanilla <pre-cutover-sha>
 // and run from there, or run it from a checkout that still has them.
 import { spawn } from 'node:child_process';
 import { cpSync, mkdtempSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
@@ -12,8 +12,12 @@ description:
 The snapshot is the only objective evidence that no content was lost.
 The vanilla site was deleted at cutover. To compare against it, check the
 pre-cutover tree out into a scratch worktree first:
 ```bash
-pnpm run serve &                                  # vanilla site on :4173
+git worktree add /tmp/vanilla <pre-cutover-sha>
 (cd /tmp/vanilla && python3 -m http.server 4173) &
 node .agents/scripts/snapshot-route.mjs http://localhost:4173/models/ \
  > .agents/snapshots/models.txt
 ```
@@ -21,8 +21,10 @@ a bug.
 ```bash
 python3 - <<'PY'
 import re
-files=['styles.css','chapters.css','landing.css','rules/styles.css','skills/styles.css',
+files=['legacy/styles/guide.css','legacy/styles/chapters.css','legacy/styles/skills.css',
-       'skills-review/styles.css','hands-on/starter/styles.css','hands-on/rules/styles.css']
+       'legacy/styles/skills-review.css','legacy/styles/change-lens.css',
       'legacy/styles/audit.css','public/hands-on/starter/styles.css',
       'public/hands-on/rules/styles.css']
 seen={}
 for f in files:
    for m in re.finditer(r'--([a-z-]+):\s*([^;}]+)', open(f).read()):
@@ -33,8 +33,9 @@ with sync_playwright() as p:
    browser.close()
 ```
-Run once against the vanilla site (`pnpm run serve`), once against
+Run once against `pnpm run preview`. To compare against the vanilla site, serve
-`pnpm run preview`. Keep both sets.
+a pre-cutover worktree on :4173 first — those files are no longer on `main`.
 Keep both sets.
 ## Compare
@@ -288,5 +288,16 @@
    "1960px",
    "2200px",
    "2880px"
  ],
  "breakpoints": [
    "520px",
    "560px",
    "600px",
    "800px",
    "880px",
    "1050px",
    "1100px",
    "1600px",
    "2200px"
  ]
 }
@@ -0,0 +1,104 @@
 [
  "01 frota",
  "02 worktrees",
  "03 modelos",
  "04 skills",
  "05 criar",
  "06 kit de campo",
  "07 prática",
  "ENGENHARIA DE IA <i></i> 01 / 2026",
  "Uma apresentação para quem entrega software",
  "Você não precisa de um exército de modelos. Precisa de um sistema: uma mente para enquadrar o trabalho, várias mãos para executá-lo e uma fronteira clara entre cada tarefa.",
  "NOTA DE CAMPO / 001",
  "Entregue o<br /><em>sistema.</em>",
  "Skills · agentes · worktrees · evidências",
  "modelo forte<br />para ambiguidade",
  "workers delimitados<br />em paralelo",
  "iterações<br />com evidências",
  "Leia isto como um mapa de rota, não como uma receita de prompt.",
  "REGRA ZERO",
  "Modelo forte para ambiguidade.<br />Modelo leve para trabalho delimitado.",
  "Uma pequena frota",
  "coordenação antes do paralelismo",
  "ORQUESTRADOR",
  "Decide o que<br />precisa acontecer.",
  "Componentes e estados visuais",
  "Casos de aceitação",
  "Guia e exemplos",
  "O orquestrador preserva a intenção, escreve pequenos contratos e reúne resultados verificáveis. Ele não precisa digitar cada linha.",
  "Por que a fronteira importa",
  "uma tarefa vaga / três falhas previsíveis",
  "Sopa de contexto",
  "Cada worker lê tudo. Ninguém sabe quais fatos são essenciais.",
  "Colisão de branches",
  "Dois agentes usam o mesmo checkout. O caminho mais rápido vira resolução de conflitos.",
  "Desvio confiante",
  "O diff parece ótimo, mas ninguém verifica se resolveu o problema original.",
  "O ciclo de subagentes",
  "Clique em uma fase.<br /><em>Veja a passagem.</em>",
  "Delegar é mover uma tarefa delimitada para um contexto menor — não abrir mão da responsabilidade.",
  "O que atravessa contextos",
  "brief → diff → evidência",
  "Pacote",
  "Contém",
  "Por que importa",
  "Git worktrees",
  "Uma branch<br />por <em>mão.</em>",
  "Um worktree é outro diretório ligado ao mesmo repositório. Cada agente recebe seu próprio checkout e índice; o histórico continua compartilhado.",
  "Selecione um nó para inspecionar checkout, responsável e próxima ação.",
  "topologia do repositório",
  "<i></i> 4 checkouts",
  "RAIZ",
  "AGENTE DE UI",
  "AGENTE DE TESTES",
  "AGENTE DE DOCS",
  "● limpo",
  "3 arquivos · trabalhando",
  "8 verificações · pronto",
  "2 páginas · revisão",
  "Roteamento de modelos",
  "Não pague por<br />raciocínio onde precisa<br />de <em>ritmo.</em>",
  "Escolha um trabalho para entender por que o perfil do modelo muda.",
  "Trabalho",
  "Perfil",
  "Formato do prompt",
  "Planejar",
  "Construir",
  "Explorar",
  "Revisar",
  "Skills",
  "Escreva do jeito certo<br /><em>uma vez.</em>",
  "Uma skill é um procedimento reutilizável. Ela pode carregar instruções, referências, scripts e assets. Não é memória mágica e não substitui critérios de aceitação.",
  "01 / defina o gatilho",
  "02 / carregue detalhes sob demanda",
  "03 / devolva evidências",
  "PACOTE DE SKILL",
  "Skills comuns",
  "escolha o comportamento antes do modelo",
  "O kit de campo",
  "Trabalhos diferentes.<br />Instintos <em>diferentes.</em>",
  "Uma skill muda como o agente aborda o trabalho. Algumas moldam a comunicação. Outras impõem pesquisa, diagnóstico, revisão ou disciplina de conclusão. Selecione uma para inspecionar sua regra operacional.",
  "SIMPLIFICAR",
  "código mínimo que funciona",
  "COMUNICAR",
  "sinal sem excesso",
  "CONCLUIR",
  "gates e evidências",
  "INVESTIGAR",
  "fontes primárias primeiro",
  "DIAGNOSTICAR",
  "ciclo curto de feedback",
  "REVISAR",
  "padrões × especificação",
  "ECONOMIZAR",
  "comprima saídas ruidosas",
  "UM LOADOUT PRÁTICO",
  "<b>PLANEJAR</b> unlazy <i>→</i> <b>CONSTRUIR</b> ponytail-lite <i>→</i> <b>DIAGNOSTICAR</b> diagnosing-bugs <i>→</i> <b>REPORTAR</b> caveman",
  "O PAPEL HUMANO",
  "O agente pode ser autônomo na execução. Intenção, limites e evidências continuam sendo seus.",
  "COMECE AQUI",
  "Comece com um agente e uma skill. Adicione paralelismo apenas quando as tarefas forem realmente independentes.",
  "Continue aprendendo",
  "12 novas leituras + documentação primária",
  "Aprofunde com documentação oficial, casos de produção, Medium e fluxos de praticantes. <a href=\"rules/\">Estudo de caso sobre regras e enforcement →</a> <a href=\"docs/references/README.md\">Referências primárias →</a> <a href=\"docs/references/additional-reading.md\">Trilha com 12 leituras →</a>"
 ]
@@ -40,11 +40,11 @@ jobs:
      # back in once it can actually diff. See task 03's report.
  publish:
-    # Until the migration finishes, `dist/` holds only /summary/ and the two
+    # `dist/` now holds all ten routes, so the stub hazard that forced this to
-    # hands-on fixtures, while the live `pages` branch serves ten pages.
+    # manual dispatch is gone. It stays manual anyway: the step below is a
-    # Publishing on every push to main would take the site down to a stub, so
+    # force-push over the live `pages` branch, and making it fire on every push
-    # this job runs only when a human asks for it. Make it unconditional on
+    # to main means every merge republishes with no human in the loop. Flipping
-    # main again at task 20 (cutover), not before.
+    # it to `push` on main is a deliberate decision, not a leftover TODO.
    if: github.event_name == 'workflow_dispatch' && inputs.publish
    needs: gate
    runs-on: ubuntu-latest
@@ -9,21 +9,9 @@ vote-service
 pnpm-lock.yaml
 public/submitted-skills
-# Legacy site sources, slated for deletion at cutover (task 20). These are
+# Unmigrated legacy sources, kept verbatim under `legacy/`. These are
 # hand-written files with very long lines; prettier re-wraps them into hundreds
-# of changed lines the moment any agent stages one. Task 15 touched app.js to
+# of changed lines the moment any agent stages one. Task 15 touched the old
-# add four lines and produced an 829-line diff. verify.mjs asserts substrings
+# app.js to add four lines and produced an 829-line diff. A reformat here is
-# against several of these, so a reformat is churn at best and a broken
+# churn at best.
-# assertion at worst.
+/legacy/
 #
 # Root-anchored on purpose: a bare `rules` would also swallow .agents/rules/,
 # whose markdown we do want formatted.
 /app.js
 /styles.css
 /landing.css
 /chapters.css
 /responsive.css
 /skills-review/
 /rules/
 /skills/
 /full-guide/
@@ -7,23 +7,16 @@ public/submitted-skills
 skill-reviews
 vote-service
-# Legacy site sources, slated for deletion at cutover (task 20). Same list and
+# Unmigrated legacy stylesheets, kept verbatim under `legacy/`. Same list and
 # same reasoning as .prettierignore: these are minified, single-line
 # stylesheets. stylelint's `declaration-block-single-line-max-declarations`
-# fires once per rule in them — ~180 errors for `styles.css` alone — so staging
+# fires once per rule in them — ~180 errors for `guide.css` alone — so staging
 # one to change a single declaration blocks the commit outright. The rule is
 # about hand-written source readability and says nothing useful about minified
-# output that is about to be deleted.
+# legacy output. Migrating one of these into `src/` means bringing it up to the
 # design system in the same change, at which point it gets linted like any
 # other source file.
 #
 # `public/fonts/fonts.css` is deliberately NOT here: it is new, hand-written,
 # and must stay linted.
-#
+/legacy/
 # Root-anchored on purpose: a bare `rules` would also swallow .agents/rules/.
 /styles.css
 /landing.css
 /chapters.css
 /responsive.css
 /skills-review/
 /rules/
 /skills/
 /full-guide/
@@ -5,8 +5,7 @@
    "hands-on/**",
    "public/hands-on/**",
    "submitted-skills/**",
-    "skill-reviews/**",
+    "skill-reviews/**"
    "vote-service/**"
  ],
  "rules": {
    "custom-property-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
@@ -12,48 +12,48 @@ rules, and verification.** It is published as a static site on a self-hosted
 Gitea Pages Server, and it doubles as its own teaching artifact: the hands-on
 labs are dependency-free HTML/CSS/JS that workshop attendees point an agent at.
- **Current stack**: hand-written HTML + CSS + ES modules, no build step, no
+- **Stack**: Astro, static output, no runtime dependencies. The migration
-  dependencies
+  recorded in [`plans/astro-refactor/`](plans/astro-refactor/README.md) is
- **Target stack**: Astro (see
+  complete; the hand-written pages it replaced are gone. What remains unmigrated
-  [`plans/astro-refactor/`](plans/astro-refactor/README.md)) — migration in
+  is the editorial CSS and the review-desk modules under `legacy/`, still
-  progress
+  imported by the pages that need them.
 - **Languages**: English and Brazilian Portuguese, toggled client-side
- **Companion service**: `vote-service/` (Go + Kubernetes) — separate lifecycle,
+- **Companion service**: a Go + Kubernetes vote API, reached over
-  see its own README
+  `window.SKILLS_REVIEW_VOTE_API`. Its source is no longer in this repository
 ## Essential commands
 ```bash
-pnpm run verify     # content + interaction contracts (scripts/verify.mjs) — the gate
+pnpm run dev        # http://localhost:4321/ai-for-dummies/
 pnpm run build      # writes dist/ — every check below reads it
 bash .agents/scripts/gate.sh # the full gate: check, build, verify, audit, tokens
 pnpm run verify     # content + interaction contracts (scripts/verify.mjs)
 node scripts/audit-ui.mjs          # responsive / no-external-dependency audit
 node scripts/build-skill-review.mjs # regenerate skill-reviews/improved/ from src/content/reviews/
 pnpm run serve      # python3 -m http.server 4173
 ```
-`pnpm run verify` is not a formality. It is a set of ~42 string-token assertions
+`pnpm run verify` is not a formality. It is a set of 84 string-token assertions
-that pin the site's real content and interactions. **A refactor that "passes" by
+that pin the site's real content and interactions, read from the built output.
-deleting assertions has failed.** See
+**A refactor that "passes" by deleting assertions has failed.** See
 [`.agents/context/verification.md`](.agents/context/verification.md).
 ## Publishing
 `main` is the source of truth. The `pages` branch is what the Gitea Pages Server
-actually serves, and its tree must end up identical to `main`'s. The full
+actually serves, and it now carries **build output**, not a copy of `main`'s
-procedure — including why `merge --ff-only` does _not_ work here — is in
+tree. The publish job force-pushes `dist/` over it. The full procedure is in
-[`docs/operations-guide.md`](docs/operations-guide.md).
+[`docs/operations-guide.md`](docs/operations-guide.md); read
-
+[`.agents/context/publishing.md`](.agents/context/publishing.md) before changing
-Adding a build step changes this contract. Read
+it.
 [`.agents/context/publishing.md`](.agents/context/publishing.md) before doing
 so.
 ## Never touch
- `hands-on/starter/` and `hands-on/rules/` — **lab fixtures.** The exercise
+- `public/hands-on/starter/` and `public/hands-on/rules/` — **lab fixtures.**
-  _is_ that they are dependency-free vanilla HTML/CSS/JS an attendee can hand to
+  The exercise _is_ that they are dependency-free vanilla HTML/CSS/JS an
-  an agent. Componentizing them destroys the lesson. They ship as static assets.
+  attendee can hand to an agent. Componentizing them destroys the lesson. They
  ship as static assets.
 - `submitted-skills/` — other people's submitted work, reproduced verbatim
 - `skill-reviews/improved/` — generated; edit `src/content/reviews/*.md` instead
 - `vote-service/` — separate deploy lifecycle; do not fold into the site build
 - `dist/`, `node_modules/` — build output, never committed
 - `pnpm-lock.yaml` — **committed, but never hand-edited.** Change it only as a
  side effect of `pnpm install`. Every worktree spins up with
@@ -1,8 +1,12 @@
 # Gates: review desk privacy and improved-draft audit
-OWNS: skills-review/**, submitted-skills/Anonymous Operational Submission/**,
+OWNS: src/pages/skills-review.astro, src/components/blocks/{ReviewDetail,
 ChangeLens,VoteWidget,PreviewPane,FileTabs}.astro, legacy/skills-review/**,
 submitted-skills/Anonymous Operational Submission/**,
 skill-reviews/improved/ndo-repro/**, scripts/verify.mjs
 The gate commands below now read `dist/`; run `pnpm run build` before them.
 Scope: Redact the operational submission's identity and URLs from the published
 review desk, keep package files usable in either preview mode, and explain each
 improved draft as a concrete diff.
@@ -15,47 +15,58 @@ skill links to a pinned source with an approval-first installation prompt.
 ## Run locally
-This is a dependency-free static site:
+This is an Astro static site. It builds to `dist/` and ships no runtime
 dependencies.
 ```bash
-python3 -m http.server 4173
+pnpm install
 pnpm run dev        # http://localhost:4321/ai-for-dummies/
 pnpm run build      # writes dist/
 pnpm run preview    # serves the built output
 ```
 Then open <http://localhost:4173>.
 Verify the content and interaction contracts with:
 ```bash
-pnpm run verify
+pnpm run verify     # reads dist/, so build first
 ```
 The full gate — `astro check`, `astro build`, `verify.mjs`, `audit-ui.mjs`,
 `check-tokens.mjs`, and the assertion-count floor — runs as:
 ```bash
 bash .agents/scripts/gate.sh
 ```
 ## Project structure
- `index.html` — default route map and focused chapter navigation
+- `src/pages/` — one file per route: the landing route map, the complete
- `full-guide/` — the complete bilingual presentation, with responsive audit
+  bilingual `full-guide`, the chapter pages, `rules`, `skills`, and
-  overrides
+  `skills-review`
- `styles.css` / `app.js` — editorial visual system and bilingual field-guide
+- `src/components/` — blocks and islands; the interactive diagrams, selectors,
-  interactions
+  and the language toggle
- `responsive.css` — interactive diagrams and Full HD-to-4K adaptations
+- `src/content/` — the content collections every page renders from
 - `src/styles/tokens.css` — the design tokens
 - `legacy/` — the editorial visual system and the review-desk modules, not yet
  migrated into components. Still imported by the pages that need them; see
  `.agents/context/architecture.md`
 - `public/` — assets copied to the site root verbatim: fonts, the hands-on labs,
  and `submitted-skills/`
 - `docs/references/` — bundled research sources and notes
 - `docs/operations-guide.md` — canonical SilverBullet operations and skills
  guide
- `hands-on/starter/` — dependency-free Tiny Tasks exercise
+- `public/hands-on/starter/` — dependency-free Tiny Tasks exercise
- `hands-on/rules/` — dependency-free Guardrails lab; toggles rule sources into
+- `public/hands-on/rules/` — dependency-free Guardrails lab; toggles rule
-  the prompt
+  sources into the prompt
- `rules/` — bilingual case study of skills, CLI ratchets, Husky, and PR review
+- `skills/` — reusable design and rules-case-study skills
 - `skills/` — reusable design and rules-case-study skills, plus an interactive
  package anatomy explorer
 - `skills-review/` — static review desk for submitted skills; its reader vote
  widget calls the separate `vote-service`
 - `vote-service/` — small Go API + Kubernetes manifests backing the
  skills-review vote widget (see `vote-service/README.md`)
 - `GATES.md` — acceptance ledger for the project
 ## Publishing
 The Gitea instance has a Pages Server configured to publish a repository’s
-`pages` branch under `pages.marcospaulo.dev.br`. The intended site address is:
+`pages` branch under `pages.marcospaulo.dev.br`. `pages` now carries the
 **built** site — the contents of `dist/` — not a copy of `main`. The intended
 site address is:
 <https://netcracker.pages.marcospaulo.dev.br/ai-for-dummies/>
@@ -70,12 +81,11 @@ skill workflow, see [docs/operations-guide.md](docs/operations-guide.md).
 ## Reader voting on the skills-review desk
 `skills-review/` is static, so its "which draft would you ship?" vote widget
-calls a separate stateful service — `vote-service/`, a small Go API on its own
+calls a separate stateful service — a small Go API on its own pod, one vote per
-pod, one vote per visitor enforced server-side by IP (a MAC address is never
+visitor enforced server-side by IP (a MAC address is never visible to a server
-visible to a server across the internet, so it cannot be used). See
+across the internet, so it cannot be used). Its source no longer lives in this
-[vote-service/README.md](vote-service/README.md) for the API, the anti-abuse
+repository; the deployed service is unchanged. `src/pages/skills-review.astro`
-design, and the build/push/deploy steps; `skills-review/index.html` sets
+sets `window.SKILLS_REVIEW_VOTE_API` to point at it.
 `window.SKILLS_REVIEW_VOTE_API` to point at it once deployed.
 ## Research
@@ -1 +0,0 @@
 <!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>
@@ -1,411 +0,0 @@
 const phases = {
  plan: { model: { en: 'OPUS / REASONING', pt: 'OPUS / RACIOCÍNIO' }, title: { en: 'Turn ambiguity into work', pt: 'Transforme ambiguidade em trabalho' }, copy: { en: 'Inspect the repository, choose the architecture, split the request, and write acceptance criteria.', pt: 'Inspecione o repositório, escolha a arquitetura, divida o pedido e escreva critérios de aceitação.' }, code: { en: 'plan → decompose → define acceptance', pt: 'planejar → decompor → definir aceitação' } },
  build: { model: { en: 'SONNET, HAIKU, OR EQUIVALENT', pt: 'SONNET, HAIKU OU EQUIVALENTE' }, title: { en: 'Execute one bounded slice', pt: 'Execute uma fatia delimitada' }, copy: { en: 'Give each worker enough context, one responsibility, and its own worktree. Less context; less collision.', pt: 'Dê a cada worker contexto suficiente, uma responsabilidade e seu próprio worktree. Menos contexto; menos colisões.' }, code: { en: 'brief + worktree → implement → test', pt: 'brief + worktree → implementar → testar' } },
  review: { model: { en: 'STRONG MODEL OR HUMAN', pt: 'MODELO FORTE OU HUMANO' }, title: { en: 'Reconnect result to intent', pt: 'Reconecte o resultado à intenção' }, copy: { en: 'Check the diff against the original brief, run the checks, then merge, request changes, or discard.', pt: 'Compare o diff com o brief original, execute as verificações e então faça merge, peça mudanças ou descarte.' }, code: { en: 'diff + checks → review → merge / iterate', pt: 'diff + verificações → revisar → merge / iterar' } }
 };
 const handsOnPrompts = {
  en: {
    basic: [
      'Work only in hands-on/starter. It is dependency-free HTML, CSS, and JavaScript.',
      '',
      'Add an All / Open / Done filter to Tiny Tasks.',
      '',
      'Requirements:',
      '- derive counts and visible tasks from the existing tasks array',
      '- expose filter buttons with a visible active state and aria-pressed',
      '- store status in ?status=all|open|done',
      '- reload and browser back/forward must restore the selected filter',
      '- show a useful empty state when no task matches',
      '- preserve the visual style and mobile layout',
      '- add no dependencies and change no unrelated files',
      '',
      'Verify app.js syntax and exercise every filter plus URL navigation.',
      'Return changed files, checks run, results, and remaining risk.'
    ].join('\n'),
    skills: [
      'Use $ponytail-lite and $webapp-testing.',
      'Work only in hands-on/starter. It is dependency-free HTML, CSS, and JavaScript.',
      '',
      'Add an All / Open / Done filter to Tiny Tasks.',
      '',
      'Apply $ponytail-lite: inspect first, reuse the current render flow, prefer native URL and button APIs, and avoid dependencies or abstractions.',
      'Apply $webapp-testing: verify all filters, aria-pressed, reload, browser back/forward, empty state, and one mobile viewport.',
      '',
      'Acceptance:',
      '- counts and visible tasks come from the existing tasks array',
      '- ?status=all|open|done is the source of truth',
      '- invalid status falls back safely to all',
      '- style remains consistent; unrelated files remain untouched',
      '',
      'Return the smallest working diff and concrete verification evidence.'
    ].join('\n')
  },
  pt: {
    basic: [
      'Trabalhe apenas em hands-on/starter. É HTML, CSS e JavaScript sem dependências.',
      '',
      'Adicione um filtro Todos / Abertos / Concluídos ao Tiny Tasks.',
      '',
      'Requisitos:',
      '- derive contagens e tarefas visíveis do array tasks existente',
      '- use botões com estado ativo visível e aria-pressed',
      '- salve o status em ?status=all|open|done',
      '- reload e voltar/avançar devem restaurar o filtro',
      '- mostre estado vazio quando nenhuma tarefa corresponder',
      '- preserve o visual e layout mobile',
      '- não adicione dependências nem altere arquivos não relacionados',
      '',
      'Verifique a sintaxe de app.js e teste filtros e navegação por URL.',
      'Retorne arquivos alterados, checks, resultados e risco restante.'
    ].join('\n'),
    skills: [
      'Use $ponytail-lite e $webapp-testing.',
      'Trabalhe apenas em hands-on/starter. É HTML, CSS e JavaScript sem dependências.',
      '',
      'Adicione um filtro Todos / Abertos / Concluídos ao Tiny Tasks.',
      '',
      'Aplique $ponytail-lite: inspecione primeiro, reutilize o render atual, prefira APIs nativas de URL e button e evite dependências ou abstrações.',
      'Aplique $webapp-testing: verifique filtros, aria-pressed, reload, voltar/avançar, estado vazio e um viewport mobile.',
      '',
      'Aceitação:',
      '- contagens e tarefas visíveis vêm do array tasks existente',
      '- ?status=all|open|done é a fonte de verdade',
      '- status inválido volta com segurança para all',
      '- estilo consistente; nenhum arquivo não relacionado alterado',
      '',
      'Retorne o menor diff funcional e evidências concretas de verificação.'
    ].join('\n')
  }
 };
 const modelGuide = {
  providers: {
    openai: {
      label: 'OpenAI', source: 'https://developers.openai.com/api/docs/guides/latest-model',
      title: { en: 'Sol · Terra · Luna', pt: 'Sol · Terra · Luna' },
      copy: { en: 'GPT-5.6 separates capability tier from reasoning effort. Sol is flagship, Terra balances performance and cost, and Luna targets efficient high-volume work.', pt: 'O GPT-5.6 separa o nível de capacidade do esforço de raciocínio. Sol é flagship, Terra equilibra desempenho e custo, e Luna atende trabalho eficiente em alto volume.' },
      tiers: [
        ['STRONG', 'Sol', { en: 'orchestration + hard judgment', pt: 'orquestração + julgamento difícil' }],
        ['BALANCED', 'Terra', { en: 'normal implementation', pt: 'implementação normal' }],
        ['FAST', 'Luna', { en: 'bounded, high-volume work', pt: 'trabalho delimitado e volumoso' }]
      ],
      config: 'reasoning: { effort: "medium" }'
    },
    claude: {
      label: 'Claude', source: 'https://docs.anthropic.com/en/docs/claude-code/model-config',
      title: { en: 'Opus · Sonnet · Haiku', pt: 'Opus · Sonnet · Haiku' },
      copy: { en: 'Claude Code exposes memorable aliases. Opus handles complex reasoning, Sonnet everyday coding, and Haiku simple fast work. The opusplan alias can plan with Opus and execute with Sonnet.', pt: 'Claude Code oferece aliases fáceis de lembrar. Opus cuida de raciocínio complexo, Sonnet do código cotidiano e Haiku de trabalho simples e rápido. O alias opusplan pode planejar com Opus e executar com Sonnet.' },
      tiers: [
        ['STRONG', 'Opus', { en: 'planning + architecture', pt: 'planejamento + arquitetura' }],
        ['BALANCED', 'Sonnet', { en: 'everyday coding', pt: 'código cotidiano' }],
        ['FAST', 'Haiku', { en: 'simple, fast tasks', pt: 'tarefas simples e rápidas' }]
      ],
      config: '/model opus  ·  /model sonnet  ·  /model haiku'
    },
    gemini: {
      label: 'Gemini', source: 'https://ai.google.dev/gemini-api/docs/thinking',
      title: { en: 'Pro · Flash · Flash-Lite', pt: 'Pro · Flash · Flash-Lite' },
      copy: { en: 'Gemini uses model families rather than interchangeable aliases. Pro targets complex reasoning, Flash balances capability and throughput, and Flash-Lite prioritizes latency and cost.', pt: 'Gemini usa famílias de modelos, não aliases intercambiáveis. Pro mira raciocínio complexo, Flash equilibra capacidade e throughput, e Flash-Lite prioriza latência e custo.' },
      tiers: [
        ['STRONG', 'Pro', { en: 'complex reasoning', pt: 'raciocínio complexo' }],
        ['BALANCED', 'Flash', { en: 'capability + throughput', pt: 'capacidade + throughput' }],
        ['FAST', 'Flash-Lite', { en: 'latency + cost', pt: 'latência + custo' }]
      ],
      config: 'thinkingConfig: { thinkingLevel: "MEDIUM" }'
    }
  },
  efforts: {
    low: { en: ['LOW', 'Use for formatting, lookup, narrow edits, and well-specified worker tasks. Optimize for fast feedback.', 'bounded task → low'], pt: ['BAIXO', 'Use para formatação, consulta, edições estreitas e tarefas de worker bem especificadas. Otimize para feedback rápido.', 'tarefa delimitada → baixo'] },
    medium: { en: ['MEDIUM', 'Balanced starting point for normal implementation, tests, and review. Measure before moving up.', 'normal build → medium'], pt: ['MÉDIO', 'Ponto inicial equilibrado para implementação normal, testes e revisão. Meça antes de subir.', 'build normal → médio'] },
    high: { en: ['HIGH', 'Use for architecture, orchestration, hard debugging, and consequential review where added latency is justified.', 'ambiguity + risk → high'], pt: ['ALTO', 'Use para arquitetura, orquestração, diagnóstico difícil e revisão importante quando a latência extra se justifica.', 'ambiguidade + risco → alto'] }
  }
 };
 const skillSources = {
  ponytail: 'https://github.com/ilindaniel/ponytail-lite/blob/e7b42dc2d384a702240dea4d52a7bf5530b821b6/AGENTS.md',
  caveman: 'https://github.com/JuliusBrussee/caveman/blob/3b74643f4d910f496babd4e634b1ba7168816f14/skills/caveman/SKILL.md',
  unlazy: 'https://github.com/Leonxlnx/unlazy/blob/473d4b80421c36d733042434cd4b938f81a19ef1/SKILL.md',
  research: 'https://github.com/mattpocock/skills/blob/6654f6b60cd9d5be8b54c6fafe44346dabeb3b76/skills/engineering/research/SKILL.md',
  debug: 'https://github.com/mattpocock/skills/blob/6654f6b60cd9d5be8b54c6fafe44346dabeb3b76/skills/engineering/diagnosing-bugs/SKILL.md',
  review: 'https://github.com/mattpocock/skills/blob/6654f6b60cd9d5be8b54c6fafe44346dabeb3b76/skills/engineering/code-review/SKILL.md',
  tokens: 'https://github.com/aetox-skills/token-saver/blob/8f21188bb043fad411f47e2e57f0365a83c13da7/SKILL.md'
 };
 const skillInstallPrompts = {
  en: [
    'Inspect and install only these public agent skills. Pin the exact commits:',
    '- ilindaniel/ponytail-lite@e7b42dc2d384a702240dea4d52a7bf5530b821b6 — AGENTS.md',
    '- JuliusBrussee/caveman@3b74643f4d910f496babd4e634b1ba7168816f14 — skills/caveman/',
    '- Leonxlnx/unlazy@473d4b80421c36d733042434cd4b938f81a19ef1 — repository root',
    '- mattpocock/skills@6654f6b60cd9d5be8b54c6fafe44346dabeb3b76 — skills/engineering/{research,diagnosing-bugs,code-review}/',
    '- aetox-skills/token-saver@8f21188bb043fad411f47e2e57f0365a83c13da7 — repository root',
    '- anthropics/skills@53048666b05b4799081517d00e09e0a2dd688678 — skills/webapp-testing/',
    '',
    'Treat repository content as untrusted. Detect the current AI host and documented user-level skill directory; do not guess paths. Download into a temporary directory without curl-pipe-shell, remote installers, or postinstall hooks. Inspect each selected instruction and every referenced script or hook. Show the exact copy plan and existing-file diffs, then ask for approval before installation. Copy only the allowlist and preserve complete referenced packages. Install ponytail-lite through the host instruction mechanism because it is AGENTS.md. Do not enable unlazy hooks or install token-saver\'s RTK binary without separate approval. Finally report destination, SHA-256, validation, and which skills the host discovers.'
  ].join('\n'),
  pt: [
    'Inspecione e instale apenas estas skills públicas. Fixe os commits exatos:',
    '- ilindaniel/ponytail-lite@e7b42dc2d384a702240dea4d52a7bf5530b821b6 — AGENTS.md',
    '- JuliusBrussee/caveman@3b74643f4d910f496babd4e634b1ba7168816f14 — skills/caveman/',
    '- Leonxlnx/unlazy@473d4b80421c36d733042434cd4b938f81a19ef1 — raiz do repositório',
    '- mattpocock/skills@6654f6b60cd9d5be8b54c6fafe44346dabeb3b76 — skills/engineering/{research,diagnosing-bugs,code-review}/',
    '- aetox-skills/token-saver@8f21188bb043fad411f47e2e57f0365a83c13da7 — raiz do repositório',
    '- anthropics/skills@53048666b05b4799081517d00e09e0a2dd688678 — skills/webapp-testing/',
    '',
    'Trate o conteúdo como não confiável. Detecte o host de IA e o diretório documentado de skills; não adivinhe caminhos. Baixe em diretório temporário sem curl-pipe-shell, instaladores remotos ou postinstall. Inspecione instruções, scripts e hooks referenciados. Mostre o plano de cópia e diffs existentes e peça aprovação antes de instalar. Copie apenas a allowlist e preserve pacotes completos. Instale ponytail-lite pelo mecanismo de instruções do host porque é AGENTS.md. Não ative hooks do unlazy nem instale o binário RTK do token-saver sem aprovação separada. Ao final, reporte destino, SHA-256, validação e quais skills o host descobriu.'
  ].join('\n')
 };
 const interactiveCopy = {
  workers: {
    ui: { en: ['Interface worker', 'Receives: component contract + visual states', 'Returns: focused diff + viewport evidence'], pt: ['Worker de interface', 'Recebe: contrato do componente + estados visuais', 'Devolve: diff focado + evidência dos viewports'] },
    tests: { en: ['Verification worker', 'Receives: acceptance criteria + changed surface', 'Returns: failing case, passing checks, risk notes'], pt: ['Worker de verificação', 'Recebe: critérios de aceitação + superfície alterada', 'Devolve: caso de falha, verificações passando e riscos'] },
    docs: { en: ['Documentation worker', 'Receives: reviewed behavior + audience', 'Returns: guide, examples, and migration notes'], pt: ['Worker de documentação', 'Recebe: comportamento revisado + público', 'Devolve: guia, exemplos e notas de migração'] }
  },
  trees: {
    main: { status: 'clean', owner: { en: 'Orchestrator', pt: 'Orquestrador' }, path: './project', command: 'git worktree list', note: { en: 'Shared history and integration point. Workers never edit here.', pt: 'Histórico compartilhado e ponto de integração. Workers nunca editam aqui.' } },
    ui: { status: 'working', owner: { en: 'UI worker', pt: 'Worker de UI' }, path: '../task-ui', command: 'git worktree add ../task-ui -b agent/ui', note: { en: 'Own checkout and index. Safe to change presentation files in parallel.', pt: 'Checkout e índice próprios. Seguro para alterar a apresentação em paralelo.' } },
    tests: { status: 'ready', owner: { en: 'Test worker', pt: 'Worker de testes' }, path: '../task-tests', command: 'git diff main...agent/tests', note: { en: 'Checks are green. Review the diff before merging into main.', pt: 'Verificações passaram. Revise o diff antes do merge em main.' } },
    docs: { status: 'review', owner: { en: 'Docs worker', pt: 'Worker de docs' }, path: '../task-docs', command: 'git merge --no-ff agent/docs', note: { en: 'Review requested. Merge, request changes, or discard without touching another checkout.', pt: 'Revisão solicitada. Faça merge, peça mudanças ou descarte sem tocar em outro checkout.' } }
  },
  routes: {
    plan: { score: 92, label: { en: 'High ambiguity', pt: 'Alta ambiguidade' }, why: { en: 'Architecture and decomposition have a wide error surface. Spend reasoning here.', pt: 'Arquitetura e decomposição têm grande superfície de erro. Invista raciocínio aqui.' } },
    build: { score: 38, label: { en: 'Bounded execution', pt: 'Execução delimitada' }, why: { en: 'The brief already removed ambiguity. Optimize for speed and tight feedback.', pt: 'O brief já removeu a ambiguidade. Otimize para velocidade e feedback curto.' } },
    explore: { score: 22, label: { en: 'Read-only discovery', pt: 'Descoberta somente leitura' }, why: { en: 'Search, map, and report. A lightweight model can return facts without editing.', pt: 'Busque, mapeie e reporte. Um modelo leve devolve fatos sem editar.' } },
    review: { score: 74, label: { en: 'Independent judgment', pt: 'Julgamento independente' }, why: { en: 'Reconnect the diff to intent with fresh context and adversarial attention.', pt: 'Reconecte o diff à intenção com contexto novo e atenção crítica.' } }
  },
  skillFiles: {
    skill: { icon: '◇', title: 'SKILL.md', en: 'Trigger, procedure, constraints, and the exact evidence the agent must return.', pt: 'Gatilho, procedimento, restrições e a evidência exata que o agente deve devolver.' },
    references: { icon: '≡', title: 'references/', en: 'Stable facts loaded only when the procedure needs them. Keep the main instruction lean.', pt: 'Fatos estáveis carregados apenas quando o procedimento precisa. Mantenha a instrução principal enxuta.' },
    scripts: { icon: '›_', title: 'scripts/', en: 'Deterministic checks and repeated operations. Prefer executable proof over prose.', pt: 'Verificações determinísticas e operações repetidas. Prefira prova executável a prosa.' },
    assets: { icon: '▧', title: 'assets/', en: 'Templates and examples the agent can copy without reinventing the expected shape.', pt: 'Templates e exemplos que o agente pode copiar sem reinventar o formato esperado.' }
  },
  skillWorkflow: {
    observe: { number: '01', title: { en: 'Start from repeated friction', pt: 'Comece pelo atrito repetido' }, question: { en: 'Which non-obvious decision keeps being rediscovered?', pt: 'Qual decisão não óbvia continua sendo redescoberta?' }, action: { en: 'Collect two or three realistic requests. Separate durable judgment from one project’s temporary details.', pt: 'Colete dois ou três pedidos realistas. Separe julgamento durável dos detalhes temporários de um projeto.' }, output: { en: 'A narrow capability and concrete examples.', pt: 'Uma capacidade estreita e exemplos concretos.' }, proof: { en: 'Without the skill, agents repeatedly make the same avoidable mistake.', pt: 'Sem a skill, agentes repetem o mesmo erro evitável.' } },
    trigger: { number: '02', title: { en: 'Make discovery precise', pt: 'Torne a descoberta precisa' }, question: { en: 'When should this load—and when should it stay out?', pt: 'Quando isto deve carregar — e quando deve ficar de fora?' }, action: { en: 'Choose a short action-oriented name. Write a discriminating description that names the task and meaningful boundary.', pt: 'Escolha um nome curto orientado à ação. Escreva uma descrição discriminante que nomeie a tarefa e seu limite.' }, output: { en: 'YAML name + description in SKILL.md.', pt: 'Nome + descrição YAML em SKILL.md.' }, proof: { en: 'Relevant prompts select it; nearby unrelated prompts do not.', pt: 'Prompts relevantes selecionam; prompts próximos mas não relacionados, não.' } },
    scaffold: { number: '03', title: { en: 'Choose only useful anatomy', pt: 'Escolha apenas a anatomia útil' }, question: { en: 'What must be instructions, executable, consulted, or copied?', pt: 'O que deve ser instrução, executável, consultado ou copiado?' }, action: { en: 'Keep shared guidance in SKILL.md. Add scripts for repeated deterministic work, references for conditional facts, and assets for generated output.', pt: 'Mantenha orientação comum em SKILL.md. Adicione scripts para trabalho determinístico, referências para fatos condicionais e assets para saída.' }, output: { en: 'Smallest folder structure that supports the workflow.', pt: 'A menor estrutura de pastas que sustenta o fluxo.' }, proof: { en: 'Every file has a real caller; no placeholder directories.', pt: 'Cada arquivo tem um consumidor real; nenhuma pasta placeholder.' } },
    write: { number: '04', title: { en: 'Write what changes decisions', pt: 'Escreva o que muda decisões' }, question: { en: 'What would a capable agent still get wrong?', pt: 'O que um agente capaz ainda erraria?' }, action: { en: 'State outcome, non-obvious constraints, routing, and stopping conditions. Remove generic advice, duplicate facts, and speculative rules.', pt: 'Declare resultado, restrições não óbvias, roteamento e condições de parada. Remova conselhos genéricos, fatos duplicados e regras especulativas.' }, output: { en: 'Lean SKILL.md with progressive links.', pt: 'SKILL.md enxuto com links progressivos.' }, proof: { en: 'Another agent can act correctly without loading irrelevant detail.', pt: 'Outro agente consegue agir corretamente sem carregar detalhes irrelevantes.' } },
    validate: { number: '05', title: { en: 'Test behavior, then sharpen', pt: 'Teste comportamento, depois refine' }, question: { en: 'Did the skill improve a realistic outcome?', pt: 'A skill melhorou um resultado realista?' }, action: { en: 'Run structural validation, execute every new script, and forward-test realistic requests. Fix observed failures with the narrowest rule.', pt: 'Execute validação estrutural, rode cada script novo e teste pedidos realistas. Corrija falhas observadas com a regra mais estreita.' }, output: { en: 'Validated package plus evidence from real use.', pt: 'Pacote validado mais evidência de uso real.' }, proof: { en: 'quick_validate passes and behavior improves without unrelated side effects.', pt: 'quick_validate passa e o comportamento melhora sem efeitos colaterais.' } }
  },
  commonSkills: {
    ponytail: { number: '01', kind: { en: 'SIMPLIFICATION INSTINCT', pt: 'INSTINTO DE SIMPLIFICAÇÃO' }, title: 'ponytail-lite', rule: { en: 'Stop at the first rung that holds.', pt: 'Pare no primeiro degrau que sustenta.' }, use: { en: 'Use when a request invites frameworks, dependencies, abstractions, or speculative scaffolding. It checks reuse, standard library, and native platform features before adding code.', pt: 'Use quando um pedido convida frameworks, dependências, abstrações ou scaffolding especulativo. Verifica reúso, biblioteca padrão e recursos nativos antes de adicionar código.' }, example: { en: 'Date picker? Start with &lt;input type="date"&gt;.', pt: 'Seletor de data? Comece com &lt;input type="date"&gt;.' }, caution: { en: 'Never simplify away security, accessibility, validation, or real edge cases.', pt: 'Nunca simplifique segurança, acessibilidade, validação ou casos extremos reais.' } },
    caveman: { number: '02', kind: { en: 'COMMUNICATION STYLE', pt: 'ESTILO DE COMUNICAÇÃO' }, title: 'caveman', rule: { en: 'Signal first. Drop filler.', pt: 'Sinal primeiro. Corte o excesso.' }, use: { en: 'Use for routine status, handoffs, and technical summaries where speed matters. Short fragments make actions and evidence easy to scan.', pt: 'Use em status, handoffs e resumos técnicos rotineiros onde velocidade importa. Fragmentos curtos facilitam localizar ações e evidências.' }, example: { en: 'Built. Tests pass. Published.', pt: 'Feito. Testes passaram. Publicado.' }, caution: { en: 'Drop the style for security warnings, irreversible actions, and sequences where terse wording can be misread.', pt: 'Abandone o estilo em alertas de segurança, ações irreversíveis e sequências onde concisão pode causar erro.' } },
    unlazy: { number: '03', kind: { en: 'COMPLETION DISCIPLINE', pt: 'DISCIPLINA DE CONCLUSÃO' }, title: 'unlazy', rule: { en: 'Define observable gates. Finish against evidence.', pt: 'Defina gates observáveis. Termine com evidências.' }, use: { en: 'Use for substantial autonomous builds, audits, and parallel work where quiet omissions are expensive. It turns “done” into runnable acceptance checks.', pt: 'Use em builds autônomos grandes, auditorias e trabalho paralelo onde omissões custam caro. Transforma “pronto” em verificações executáveis.' }, example: { en: 'Gate: language toggle persists. Check: browser reload. Expect: pt-BR.', pt: 'Gate: idioma persiste. Check: recarregar navegador. Esperado: pt-BR.' }, caution: { en: 'Too heavy for trivial edits or factual answers.', pt: 'Pesado demais para edições triviais ou respostas factuais.' } },
    research: { number: '04', kind: { en: 'SOURCE DISCIPLINE', pt: 'DISCIPLINA DE FONTES' }, title: 'research', rule: { en: 'Trace claims to owners.', pt: 'Leve afirmações até suas fontes.' }, use: { en: 'Use when APIs, standards, architecture facts, or current behavior must be verified. Capture findings in a cited note, prioritizing primary sources.', pt: 'Use quando APIs, padrões, fatos de arquitetura ou comportamento atual precisam ser verificados. Registre achados citados, priorizando fontes primárias.' }, example: { en: 'Git behavior → git-scm.com docs, not a remembered blog summary.', pt: 'Comportamento do Git → documentação git-scm.com, não memória de um blog.' }, caution: { en: 'Practitioner articles add context; they do not override official behavior.', pt: 'Artigos de praticantes dão contexto; não substituem comportamento oficial.' } },
    debug: { number: '05', kind: { en: 'DIAGNOSTIC LOOP', pt: 'CICLO DE DIAGNÓSTICO' }, title: 'diagnosing-bugs', rule: { en: 'No red-capable loop, no theory.', pt: 'Sem ciclo capaz de falhar, sem teoria.' }, use: { en: 'Use for hard bugs, flakes, and regressions. First build a fast deterministic reproduction, then minimize, rank hypotheses, instrument, and fix the root cause.', pt: 'Use para bugs difíceis, flakes e regressões. Primeiro crie reprodução rápida e determinística; depois minimize, ranqueie hipóteses, instrumente e corrija a causa raiz.' }, example: { en: 'One command reproduces the exact symptom before any fix.', pt: 'Um comando reproduz o sintoma exato antes de qualquer correção.' }, caution: { en: 'Do not jump from error message straight to a patch.', pt: 'Não pule da mensagem de erro direto para um patch.' } },
    review: { number: '06', kind: { en: 'INDEPENDENT REVIEW', pt: 'REVISÃO INDEPENDENTE' }, title: 'code-review', rule: { en: 'Check standards and intent separately.', pt: 'Verifique padrões e intenção separadamente.' }, use: { en: 'Use on a branch or PR. One axis checks repository standards; another checks whether the change actually satisfies its originating specification.', pt: 'Use em branch ou PR. Um eixo verifica padrões do repositório; outro verifica se a mudança realmente satisfaz a especificação original.' }, example: { en: 'Clean code can still solve the wrong problem.', pt: 'Código limpo ainda pode resolver o problema errado.' }, caution: { en: 'Pin the comparison point and source specification before reviewing.', pt: 'Fixe o ponto de comparação e a especificação antes de revisar.' } },
    tokens: { number: '07', kind: { en: 'CONTEXT ECONOMY', pt: 'ECONOMIA DE CONTEXTO' }, title: 'token-saver', rule: { en: 'Keep signal. Strip command noise.', pt: 'Mantenha sinal. Corte ruído de comandos.' }, use: { en: 'Use around verbose tests, builds, Git output, and logs. Filtering preserves context for reasoning while retaining full failure output for recovery.', pt: 'Use em testes, builds, saídas Git e logs verbosos. Filtragem preserva contexto para raciocínio e mantém falhas completas para recuperação.' }, example: { en: '200 passing-test lines → one result; failures keep their trace.', pt: '200 linhas de testes passando → um resultado; falhas mantêm o trace.' }, caution: { en: 'Read raw output when exact wording or full diffs matter.', pt: 'Leia saída bruta quando texto exato ou diffs completos importarem.' } }
  }
 };
 const translations = {
  pt: {
    '.chapter-links a:nth-child(1)': '01 frota', '.chapter-links a:nth-child(2)': '02 worktrees', '.chapter-links a:nth-child(3)': '03 modelos', '.chapter-links a:nth-child(4)': '04 skills', '.chapter-links a:nth-child(5)': '05 criar', '.chapter-links a:nth-child(6)': '06 kit de campo', '.chapter-links a:nth-child(7)': '07 prática', '.edition': 'ENGENHARIA DE IA <i></i> 01 / 2026',
    '.hero .eyebrow': 'Uma apresentação para quem entrega software', '.lede': 'Você não precisa de um exército de modelos. Precisa de um sistema: uma mente para enquadrar o trabalho, várias mãos para executá-lo e uma fronteira clara entre cada tarefa.', '.hero-index span': 'NOTA DE CAMPO / 001', '.hero-index strong': 'Entregue o<br /><em>sistema.</em>', '.hero-index small': 'Skills · agentes · worktrees · evidências',
    '.hero-stats div:nth-child(1) span': 'modelo forte<br />para ambiguidade', '.hero-stats div:nth-child(2) span': 'workers delimitados<br />em paralelo', '.hero-stats div:nth-child(3) span': 'iterações<br />com evidências', '.hero-stats p': 'Leia isto como um mapa de rota, não como uma receita de prompt.',
    '.thesis span': 'REGRA ZERO', '.thesis strong': 'Modelo forte para ambiguidade.<br />Modelo leve para trabalho delimitado.', '.fleet .section-label span:nth-child(1)': 'Uma pequena frota', '.fleet .section-label span:nth-child(2)': 'coordenação antes do paralelismo', '.captain span': 'ORQUESTRADOR', '.captain h2': 'Decide o que<br />precisa acontecer.', '.worker-card[data-worker="ui"] strong': 'Componentes e estados visuais', '.worker-card[data-worker="tests"] strong': 'Casos de aceitação', '.worker-card[data-worker="docs"] strong': 'Guia e exemplos', '.caption': 'O orquestrador preserva a intenção, escreve pequenos contratos e reúne resultados verificáveis. Ele não precisa digitar cada linha.',
    '.failure-map .section-label span:nth-child(1)': 'Por que a fronteira importa', '.failure-map .section-label span:nth-child(2)': 'uma tarefa vaga / três falhas previsíveis', '.failure-grid article:nth-child(1) strong': 'Sopa de contexto', '.failure-grid article:nth-child(1) p': 'Cada worker lê tudo. Ninguém sabe quais fatos são essenciais.', '.failure-grid article:nth-child(2) strong': 'Colisão de branches', '.failure-grid article:nth-child(2) p': 'Dois agentes usam o mesmo checkout. O caminho mais rápido vira resolução de conflitos.', '.failure-grid article:nth-child(3) strong': 'Desvio confiante', '.failure-grid article:nth-child(3) p': 'O diff parece ótimo, mas ninguém verifica se resolveu o problema original.',
    '.workflow .eyebrow': 'O ciclo de subagentes', '#workflow-title': 'Clique em uma fase.<br /><em>Veja a passagem.</em>', '.workflow .copy > p:last-child': 'Delegar é mover uma tarefa delimitada para um contexto menor — não abrir mão da responsabilidade.', '.handoff .section-label span:nth-child(1)': 'O que atravessa contextos', '.handoff .section-label span:nth-child(2)': 'brief → diff → evidência', '.handoff thead th:nth-child(1)': 'Pacote', '.handoff thead th:nth-child(2)': 'Contém', '.handoff thead th:nth-child(3)': 'Por que importa',
    '.worktrees .eyebrow': 'Git worktrees', '.worktrees h2': 'Uma branch<br />por <em>mão.</em>', '.worktree-intro > p:nth-of-type(2)': 'Um worktree é outro diretório ligado ao mesmo repositório. Cada agente recebe seu próprio checkout e índice; o histórico continua compartilhado.', '.worktree-intro .interaction-hint': 'Selecione um nó para inspecionar checkout, responsável e próxima ação.', '.tree-toolbar > span:first-child': 'topologia do repositório', '.tree-live': '<i></i> 4 checkouts', '.tree-node.root span': 'RAIZ', '.tree-node.ui span': 'AGENTE DE UI', '.tree-node.tests span': 'AGENTE DE TESTES', '.tree-node.docs span': 'AGENTE DE DOCS', '.tree-node.root small': '● limpo', '.tree-node.ui small': '3 arquivos · trabalhando', '.tree-node.tests small': '8 verificações · pronto', '.tree-node.docs small': '2 páginas · revisão', '.routing .eyebrow': 'Roteamento de modelos', '.routing h2': 'Não pague por<br />raciocínio onde precisa<br />de <em>ritmo.</em>', '.routing .interaction-hint': 'Escolha um trabalho para entender por que o perfil do modelo muda.', '.route-table .head span:nth-child(1)': 'Trabalho', '.route-table .head span:nth-child(2)': 'Perfil', '.route-table .head span:nth-child(3)': 'Formato do prompt', '.route-table [data-route="plan"] strong': 'Planejar', '.route-table [data-route="build"] strong': 'Construir', '.route-table [data-route="explore"] strong': 'Explorar', '.route-table [data-route="review"] strong': 'Revisar', '.skills .eyebrow': 'Skills', '.skills h2': 'Escreva do jeito certo<br /><em>uma vez.</em>', '.skills > div:first-child > p': 'Uma skill é um procedimento reutilizável. Ela pode carregar instruções, referências, scripts e assets. Não é memória mágica e não substitui critérios de aceitação.',
    '.skill-principles span:nth-child(1)': '01 / defina o gatilho', '.skill-principles span:nth-child(2)': '02 / carregue detalhes sob demanda', '.skill-principles span:nth-child(3)': '03 / devolva evidências', '.skill-package > span': 'PACOTE DE SKILL', '.skill-catalog .section-label span:nth-child(1)': 'Skills comuns', '.skill-catalog .section-label span:nth-child(2)': 'escolha o comportamento antes do modelo', '.catalog-intro .eyebrow': 'O kit de campo', '.catalog-intro h2': 'Trabalhos diferentes.<br />Instintos <em>diferentes.</em>', '.catalog-intro > p': 'Uma skill muda como o agente aborda o trabalho. Algumas moldam a comunicação. Outras impõem pesquisa, diagnóstico, revisão ou disciplina de conclusão. Selecione uma para inspecionar sua regra operacional.', '[data-common-skill="ponytail"] span': 'SIMPLIFICAR', '[data-common-skill="ponytail"] small': 'código mínimo que funciona', '[data-common-skill="caveman"] span': 'COMUNICAR', '[data-common-skill="caveman"] small': 'sinal sem excesso', '[data-common-skill="unlazy"] span': 'CONCLUIR', '[data-common-skill="unlazy"] small': 'gates e evidências', '[data-common-skill="research"] span': 'INVESTIGAR', '[data-common-skill="research"] small': 'fontes primárias primeiro', '[data-common-skill="debug"] span': 'DIAGNOSTICAR', '[data-common-skill="debug"] small': 'ciclo curto de feedback', '[data-common-skill="review"] span': 'REVISAR', '[data-common-skill="review"] small': 'padrões × especificação', '[data-common-skill="tokens"] span': 'ECONOMIZAR', '[data-common-skill="tokens"] small': 'comprima saídas ruidosas', '.skill-loadout > span': 'UM LOADOUT PRÁTICO', '.skill-loadout > div': '<b>PLANEJAR</b> unlazy <i>→</i> <b>CONSTRUIR</b> ponytail-lite <i>→</i> <b>DIAGNOSTICAR</b> diagnosing-bugs <i>→</i> <b>REPORTAR</b> caveman', '.rule span': 'O PAPEL HUMANO', '.rule strong': 'O agente pode ser autônomo na execução. Intenção, limites e evidências continuam sendo seus.', '.callout span': 'COMECE AQUI', '.callout strong': 'Comece com um agente e uma skill. Adicione paralelismo apenas quando as tarefas forem realmente independentes.', '.sources .section-label span:nth-child(1)': 'Continue aprendendo', '.sources .section-label span:nth-child(2)': '12 novas leituras + documentação primária', '.sources p': 'Aprofunde com documentação oficial, casos de produção, Medium e fluxos de praticantes. <a href="rules/">Estudo de caso sobre regras e enforcement →</a> <a href="docs/references/README.md">Referências primárias →</a> <a href="docs/references/additional-reading.md">Trilha com 12 leituras →</a>'
  }
 };
 Object.assign(translations.pt, {
  '.model-gearbox .section-label span:nth-child(1)': 'Câmbio de modelos', '.model-gearbox .section-label span:nth-child(2)': 'nível de capacidade × esforço de raciocínio',
  '.gearbox-intro .eyebrow': 'Dois controles separados', '.gearbox-intro h2': 'Escolha o motor.<br />Depois escolha a <em>marcha.</em>',
  '.gearbox-intro > p': 'Um modelo mais forte muda o teto de capacidade. Mais esforço de raciocínio dá mais espaço para esse modelo trabalhar. Comece com a combinação mais leve que passa seus checks e mova um controle por vez.',
  '.effort-rail > span': 'RACIOCÍNIO / PENSAMENTO', '[data-effort="low"] b': 'BAIXO', '[data-effort="low"] small': 'delimitado + rápido', '[data-effort="medium"] b': 'MÉDIO', '[data-effort="medium"] small': 'ponto inicial', '[data-effort="high"] b': 'ALTO', '[data-effort="high"] small': 'complexo + custoso',
  '.gearbox-rule span': 'REGRA DE ROTEAMENTO', '.gearbox-rule strong': 'Use modelos fortes para ambiguidade e julgamento. Use modelos leves para execução delimitada. Aumente o esforço apenas quando a avaliação mostrar ganho.',
  '.skill-builder .section-label span:nth-child(1)': 'Criar uma skill',
  '.skill-builder .section-label span:nth-child(2)': 'atrito repetido → julgamento reutilizável',
  '.builder-intro .eyebrow': 'A forja de skills',
  '.builder-intro h2': 'Ensine a decisão.<br />Mantenha o contexto <em>leve.</em>',
  '.builder-intro > p': 'Não empacote tudo o que você sabe. Capture as escolhas não óbvias que melhoram resultados repetidamente e prove que a skill muda o comportamento.',
  '[data-skill-step="observe"] span': 'Observar', '[data-skill-step="observe"] small': 'encontre atrito repetido',
  '[data-skill-step="trigger"] span': 'Definir gatilho', '[data-skill-step="trigger"] small': 'roteie com precisão',
  '[data-skill-step="scaffold"] span': 'Escolher anatomia', '[data-skill-step="scaffold"] small': 'apenas arquivos necessários',
  '[data-skill-step="write"] span': 'Escrever orientação', '[data-skill-step="write"] small': 'decisões, não trivialidades',
  '[data-skill-step="validate"] span': 'Validar', '[data-skill-step="validate"] small': 'teste comportamento real',
  '.artifact-head span': 'SAÍDA / PACOTE DE SKILL', '.artifact-command span': 'VALIDAR',
  '.builder-loop > span': 'APÓS USO REAL',
  '.builder-loop > div': '<b>observar falha</b><i>→</i><b>refinar uma regra</b><i>→</i><b>retestar comportamento</b><i>→</i><b>manter estreita</b>',
  '.install-skills header span': 'PACOTE DE INSTALAÇÃO', '.install-skills header strong': 'Peça ao seu agente para verificar, instalar e validar as skills.',
  '.install-skills footer': 'Revise cada fonte antes da instalação. Skills locais existentes devem ser preservadas.',
  '.hands-on .section-label span:nth-child(1)': 'Prática', '.hands-on .section-label span:nth-child(2)': '10 minutos / uma feature ausente',
  '.hands-intro .eyebrow': 'Laboratório Tiny Tasks', '.hands-intro h2': 'Mesma tarefa.<br />Melhor <em>sistema operacional.</em>',
  '.hands-intro > div:last-child > p': 'Comece com um quadro estático propositalmente incompleto. Execute um prompt, restaure e execute a versão com skills. Compare tamanho do diff, evidências e complexidade desnecessária.',
  '.starter-link': 'Abrir o projeto inicial →', '.exercise-brief > span': 'A FEATURE AUSENTE',
  '.exercise-brief > strong': 'Adicione filtros Todos / Abertos / Concluídos que sobrevivem reload e navegação.',
  '.exercise-brief > div': '<b>STACK</b> HTML · CSS · JavaScript <b>DEPENDÊNCIAS</b> nenhuma <b>ARQUIVOS</b> 3',
  '.prompt-card:first-child header strong': 'Bom prompt', '.prompt-card.enhanced header strong': 'Bom prompt + skills',
  '.prompt-card:first-child footer': 'Contexto claro · restrições · aceitação · evidência', '.prompt-card.enhanced footer': 'Mesmo contrato · métodos explícitos · prova mais forte',
  '.comparison-strip > span': 'COMPARE AS EXECUÇÕES', '.comparison-strip > div:nth-child(2)': '<b>01</b> Arquivos alterados', '.comparison-strip > div:nth-child(3)': '<b>02</b> Novas dependências', '.comparison-strip > div:nth-child(4)': '<b>03</b> Checks executados', '.comparison-strip > div:nth-child(5)': '<b>04</b> Evidências retornadas'
 });
 const panel = document.querySelector('#phase-panel');
 const buttons = document.querySelectorAll('[data-phase]');
 const originals = new Map();
 let currentLanguage = 'en';
 function setText(selector, value) {
  const nodes = document.querySelectorAll(selector);
  if (!nodes.length) return;
  if (!originals.has(selector)) originals.set(selector, [...nodes].map((node) => node.innerHTML));
  nodes.forEach((node) => { node.innerHTML = value; });
 }
 function render(id) {
  const phase = phases[id];
  panel.innerHTML = `<div class="phase-meta"><span>${phase.model[currentLanguage]}</span><small>${currentLanguage === 'pt' ? 'contexto: isolado' : 'context: isolated'}</small></div><h3>${phase.title[currentLanguage]}</h3><p>${phase.copy[currentLanguage]}</p><code>${phase.code[currentLanguage]}</code>`;
  buttons.forEach((button) => { const active = button.dataset.phase === id; button.classList.toggle('active', active); button.setAttribute('aria-selected', String(active)); });
 }
 function selectButtons(selector, activeValue, key) {
  document.querySelectorAll(selector).forEach((button) => {
    const active = button.dataset[key] === activeValue;
    button.classList.toggle('active', active);
    button.setAttribute(button.hasAttribute('aria-selected') ? 'aria-selected' : 'aria-pressed', String(active));
  });
 }
 function renderWorker(id) {
  const item = interactiveCopy.workers[id][currentLanguage];
  document.querySelector('#worker-detail').innerHTML = `<span>${item[0]}</span><strong>${item[1]}</strong><small>${item[2]}</small>`;
  selectButtons('[data-worker]', id, 'worker');
 }
 function renderTree(id) {
  const item = interactiveCopy.trees[id];
  const language = currentLanguage;
  document.querySelector('#tree-detail').innerHTML = `<div><span>${language === 'pt' ? 'RESPONSÁVEL' : 'OWNER'}</span><strong>${item.owner[language]}</strong></div><div><span>CHECKOUT</span><strong>${item.path}</strong></div><p>${item.note[language]}</p><code>${item.command}</code>`;
  selectButtons('[data-tree]', id, 'tree');
 }
 function renderRoute(id) {
  const item = interactiveCopy.routes[id];
  const language = currentLanguage;
  document.querySelector('#route-detail').innerHTML = `<div class="route-meter"><span style="--score:${item.score}%"></span></div><div><small>${language === 'pt' ? 'CARGA DE RACIOCÍNIO' : 'REASONING LOAD'} · ${item.score}</small><strong>${item.label[language]}</strong><p>${item.why[language]}</p></div>`;
  selectButtons('[data-route]', id, 'route');
 }
 function renderModelProvider(id) {
  const item = modelGuide.providers[id];
  const language = currentLanguage;
  const sourceLabel = language === 'pt' ? 'FONTE OFICIAL ↗' : 'OFFICIAL SOURCE ↗';
  const kindLabels = language === 'pt' ? { STRONG: 'FORTE', BALANCED: 'EQUILÍBRIO', FAST: 'RÁPIDO' } : {};
  const tiers = item.tiers.map(([kind, name, note]) => `<div><span>${kindLabels[kind] || kind}</span><strong>${name}</strong><small>${note[language]}</small></div>`).join('');
  document.querySelector('#provider-detail').innerHTML = `<header><span>${item.label}</span><a href="${item.source}" target="_blank" rel="noopener">${sourceLabel}</a></header><h3>${item.title[language]}</h3><p>${item.copy[language]}</p><div class="model-ladder">${tiers}</div>`;
  selectButtons('[data-model-provider]', id, 'modelProvider');
 }
 function renderEffort(id) {
  const item = modelGuide.efforts[id][currentLanguage];
  const provider = modelGuide.providers[document.querySelector('[data-model-provider].active')?.dataset.modelProvider || 'openai'];
  document.querySelector('#effort-detail').innerHTML = `<span>${item[0]}</span><p>${item[1]}</p><code>${provider.config}</code>`;
  selectButtons('[data-effort]', id, 'effort');
 }
 function renderSkillFile(id) {
  const item = interactiveCopy.skillFiles[id];
  document.querySelector('#skill-detail').innerHTML = `<span>${item.icon}</span><div><strong>${item.title}</strong><p>${item[currentLanguage]}</p><small>${currentLanguage === 'pt' ? 'clique em outro arquivo para explorar' : 'select another file to explore'}</small></div>`;
  selectButtons('[data-skill-file]', id, 'skillFile');
 }
 function renderSkillWorkflow(id) {
  const item = interactiveCopy.skillWorkflow[id];
  const language = currentLanguage;
  const labels = language === 'pt'
    ? ['PERGUNTA', 'AÇÃO', 'ARTEFATO', 'PROVA']
    : ['QUESTION', 'ACTION', 'ARTIFACT', 'PROOF'];
  document.querySelector('#builder-detail').innerHTML = `<header><span>${item.number}</span><small>${labels[0]}</small></header><h3>${item.title[language]}</h3><blockquote>${item.question[language]}</blockquote><div class="builder-action"><span>${labels[1]}</span><p>${item.action[language]}</p></div><footer><div><span>${labels[2]}</span><strong>${item.output[language]}</strong></div><div><span>${labels[3]}</span><strong>${item.proof[language]}</strong></div></footer>`;
  selectButtons('[data-skill-step]', id, 'skillStep');
 }
 function renderCommonSkill(id) {
  const item = interactiveCopy.commonSkills[id];
  const language = currentLanguage;
  const labels = language === 'pt'
    ? ['QUANDO USAR', 'EXEMPLO', 'CUIDADO']
    : ['WHEN TO USE', 'EXAMPLE', 'WATCH OUT'];
  const sourceLabel = language === 'pt' ? 'FONTE NO GITHUB ↗' : 'GITHUB SOURCE ↗';
  document.querySelector('#common-skill-detail').innerHTML = `<header><span>${item.number}</span><small>${item.kind[language]}</small></header><h3>${item.title}</h3><blockquote>${item.rule[language]}</blockquote><div class="common-skill-notes"><div><span>${labels[0]}</span><p>${item.use[language]}</p></div><div><span>${labels[1]}</span><p>${item.example[language]}</p></div><div><span>${labels[2]}</span><p>${item.caution[language]}</p></div></div><a class="skill-source" href="${skillSources[id]}" target="_blank" rel="noopener">${sourceLabel}</a>`;
  selectButtons('[data-common-skill]', id, 'commonSkill');
 }
 function renderHandsOn() {
  document.querySelector('#prompt-basic').textContent = handsOnPrompts[currentLanguage].basic;
  document.querySelector('#prompt-skills').textContent = handsOnPrompts[currentLanguage].skills;
  document.querySelector('#prompt-install-skills').textContent = skillInstallPrompts[currentLanguage];
  document.querySelectorAll('[data-copy-target] span').forEach((label) => { label.textContent = currentLanguage === 'pt' ? 'COPIAR' : 'COPY'; });
 }
 async function copyPrompt(button) {
  const text = document.querySelector(`#${button.dataset.copyTarget}`).textContent;
  let copied = false;
  try {
    await navigator.clipboard.writeText(text);
    copied = true;
  } catch (error) {
    const helper = document.createElement('textarea');
    helper.value = text;
    helper.setAttribute('readonly', '');
    helper.style.position = 'fixed';
    helper.style.opacity = '0';
    document.body.appendChild(helper);
    helper.select();
    copied = document.execCommand('copy');
    helper.remove();
  }
  const status = document.querySelector('#copy-status');
  status.textContent = copied
    ? (currentLanguage === 'pt' ? 'Prompt copiado. Cole em uma nova sessão de agente.' : 'Prompt copied. Paste it into a fresh agent session.')
    : (currentLanguage === 'pt' ? 'Não foi possível copiar. Selecione o texto manualmente.' : 'Copy unavailable. Select the text manually.');
  if (copied) {
    button.classList.add('copied');
    button.querySelector('span').textContent = currentLanguage === 'pt' ? 'COPIADO' : 'COPIED';
    window.setTimeout(() => { button.classList.remove('copied'); button.querySelector('span').textContent = currentLanguage === 'pt' ? 'COPIAR' : 'COPY'; }, 1800);
  }
 }
 function renderInteractive() {
  renderWorker(document.querySelector('[data-worker].active')?.dataset.worker || 'ui');
  renderTree(document.querySelector('[data-tree].active')?.dataset.tree || 'main');
  renderRoute(document.querySelector('[data-route].active')?.dataset.route || 'plan');
  renderModelProvider(document.querySelector('[data-model-provider].active')?.dataset.modelProvider || 'openai');
  renderEffort(document.querySelector('[data-effort].active')?.dataset.effort || 'medium');
  renderSkillFile(document.querySelector('[data-skill-file].active')?.dataset.skillFile || 'skill');
  renderSkillWorkflow(document.querySelector('[data-skill-step].active')?.dataset.skillStep || 'observe');
  renderCommonSkill(document.querySelector('[data-common-skill].active')?.dataset.commonSkill || 'ponytail');
  renderHandsOn();
 }
 function applyLanguage(language) {
  currentLanguage = language === 'pt' ? 'pt' : 'en';
  document.documentElement.lang = currentLanguage === 'pt' ? 'pt-BR' : 'en';
  if (currentLanguage === 'pt') Object.entries(translations.pt).forEach(([selector, value]) => setText(selector, value));
  else originals.forEach((values, selector) => document.querySelectorAll(selector).forEach((node, index) => { node.innerHTML = values[index]; }));
  document.querySelectorAll('[data-lang]').forEach((button) => { const active = button.dataset.lang === currentLanguage; button.classList.toggle('active', active); button.setAttribute('aria-pressed', String(active)); });
  render(document.querySelector('[data-phase].active')?.dataset.phase || 'plan');
  renderInteractive();
  try { localStorage.setItem('ai-for-dummies-language', currentLanguage); } catch (error) { /* previews may disable storage */ }
 }
 buttons.forEach((button) => button.addEventListener('click', () => render(button.dataset.phase)));
 document.querySelectorAll('[data-lang]').forEach((button) => button.addEventListener('click', () => applyLanguage(button.dataset.lang)));
 document.querySelectorAll('[data-worker]').forEach((button) => button.addEventListener('click', () => renderWorker(button.dataset.worker)));
 document.querySelectorAll('[data-tree]').forEach((button) => button.addEventListener('click', () => renderTree(button.dataset.tree)));
 document.querySelectorAll('[data-route]').forEach((button) => button.addEventListener('click', () => renderRoute(button.dataset.route)));
 document.querySelectorAll('[data-model-provider]').forEach((button) => button.addEventListener('click', () => { renderModelProvider(button.dataset.modelProvider); renderEffort(document.querySelector('[data-effort].active')?.dataset.effort || 'medium'); }));
 document.querySelectorAll('[data-effort]').forEach((button) => button.addEventListener('click', () => renderEffort(button.dataset.effort)));
 document.querySelectorAll('[data-skill-file]').forEach((button) => button.addEventListener('click', () => renderSkillFile(button.dataset.skillFile)));
 document.querySelectorAll('[data-skill-step]').forEach((button) => button.addEventListener('click', () => renderSkillWorkflow(button.dataset.skillStep)));
 document.querySelectorAll('[data-common-skill]').forEach((button) => button.addEventListener('click', () => renderCommonSkill(button.dataset.commonSkill)));
 document.querySelectorAll('[data-copy-target]').forEach((button) => button.addEventListener('click', () => copyPrompt(button)));
 window.addEventListener('scroll', () => { const height = document.documentElement.scrollHeight - window.innerHeight; document.querySelector('.reading-progress span').style.width = `${height > 0 ? (window.scrollY / height) * 100 : 0}%`; }, { passive: true });
 let savedLanguage = 'en';
 try { savedLanguage = localStorage.getItem('ai-for-dummies-language') || 'en'; } catch (error) { /* previews may disable storage */ }
 render('plan');
 applyLanguage(savedLanguage);
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Marcos Paulo	9015e7bd1d	chore: take vote-service out of the repository root verify-and-publish / publish (push) Blocked by required conditions Details verify-and-publish / gate (push) Has started running Details Removes the Go source, Dockerfile, go.mod, and Kubernetes manifests. The deployed service is untouched and the review desk still calls it over window.SKILLS_REVIEW_VOTE_API; only the source leaves. The runbook does not leave. vote-service/README.md moves to docs/vote-service.md, because it carries the parts that are hard to rediscover: why the ingress overwrites X-Forwarded-For and Caddy stamps X-Client-IP instead, why the image is side-loaded into containerd rather than pulled, and why the PVC pins the Deployment to one node. This drops verify.mjs from 84 assertions to 83. The removed one read vote-service/main.go for X-Forwarded-For and 'one active vote per skill' -- the review desk's only anti-abuse control -- and there is no file left to read. It is the first assertion this repository has ever lost. Rather than lower the gate's floor and leave a bare number behind, gate.sh now subtracts the number of entries in .agents/context/assertion-removals.md from the baseline. A removal costs a written reason in a tracked file, in the same commit, as a visible diff. Tested at 82 assertions: still refused. Also drops the 22 MB of PNG baselines under .agents/snapshots/before/ and before-reduced-motion/. They pictured the hand-written site, which no longer exists; visual-regression.mjs has no compare mode to diff them against; and they are recoverable from `d88d8b8`. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-06 08:59:45 +00:00
Marcos Paulo	d88d8b89eb	refactor: cut over to the Astro build verify-and-publish / gate (push) Successful in 7m30s Details verify-and-publish / publish (push) Has been skipped Details Merges refactor/task-20-cutover. Task 20 steps 1, 2, and 5; publishing is not included. The hand-written site is gone: 32 files deleted, including app.js, responsive.css, and all ten route index.html files. Twelve more could not be deleted -- the Astro pages import them and the build fails without them -- so they moved to legacy/ verbatim, outside the reach of check-tokens.mjs, which sweeps src/ and would demand a token migration these files have not had. Before anything was deleted, rendered-text-diff swept all ten routes plus both Portuguese pages at full parity, 0 missing and 0 extra. That comparison stops being possible once the legacy files are gone, which is why it ran first. computed-style-diff on /full-guide/ is unchanged at 32. verify.mjs no longer reads app.js and holds at 84 assertions. audit-ui.mjs reads dist/. Docs across README, AGENTS.md, GATES.md, the architecture context, and the operations guide now describe the built site rather than the hand-written one. origin/pages is unchanged at `37a1e480c6`. The publish job is still gated to manual dispatch. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-06 08:31:33 +00:00
Marcos Paulo	b119b92948	docs: correct the publish job's stale gating comment dist/ now holds all ten routes. The job stays on manual dispatch, and the comment now says that is a choice rather than a migration workaround. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-06 08:31:20 +00:00
Marcos Paulo	580293867d	refactor: retire the hand-written site Deletes the pre-Astro pages, scripts, and stylesheets that the migration replaced, and moves the ones it did not replace out of the way. Deleted (32 files): app.js, responsive.css, landing.css, rules/app.js, rules/styles.css, skills/app.js, the ten route index.html files, and the root hands-on/ copy, which is byte-identical to public/hands-on/ -- the one the build actually ships. Moved to legacy/ (12 files): styles.css, full-guide/audit.css, chapters.css, skills/styles.css, skills-review/styles.css, skills-review/change-lens.css, and the skills-review/app.js module graph. These are not dead. The Astro pages import them and the build fails without them, which the plan had not accounted for. They go to legacy/ rather than src/ because check-tokens.mjs sweeps src, and these files are full of raw hex and unnamed breakpoints: moving one into src/ should mean migrating it to tokens in the same change, not adding a scan exclusion. The prettier, stylelint, and eslint ignore lists that already named these files at their old paths now name legacy/ instead. verify.mjs no longer reads app.js. The 102 Portuguese strings were extracted from its translations.pt object before deletion into .agents/snapshots/full-guide-pt.json -- a legacy capture, not a snapshot of the Astro build, so the assertion still compares against an independent source. The brace-matching helper's assertion is replaced by one that rejects an empty snapshot entry, without which trimming the snapshot would make the presence check pass vacuously. Count stays at 84. audit-ui.mjs reads the ten pages from dist/ and resolves Astro's base-absolute hrefs against it. Before deleting anything, rendered-text-diff was run across all ten routes plus both Portuguese pages: every one at parity, 0 missing and 0 extra. That comparison is not repeatable once the legacy files are gone. computed-style-diff on /full-guide/ stays at 32 differences, so the moves are style-neutral. Docs updated to match: README, AGENTS.md, GATES.md, the architecture context, the operations guide's lab instructions, and the three skills that told you to serve the vanilla site. Publishing is not part of this commit. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-06 08:30:27 +00:00
Marcos Paulo	9cb1e0d242	fix: make the audit-ui value contract unfakeable The value baseline was satisfied by the string appearing anywhere in the built CSS. Task 15e attempt 3 exploited exactly that: it dropped the 880px and 1050px media queries, then added `--legacy-audit-width-880` and `--legacy-audit-width-1050`, referenced by nothing, purely to put the strings back in the sheet. The audit reported success. Two changes close it: - Custom-property declarations nothing references via `var()` are stripped before the value scan. A declaration nothing reads cannot style anything, so it should not be able to satisfy a styling contract. - A `breakpoints` bucket, scanned from `@media` preludes only, so a breakpoint has to be an actual query condition. Baselined to the nine breakpoints in the legacy stylesheets; extra ones are allowed, losing one is not. Both were tested against a rebuilt dist with the 880px queries removed: the dead-token form fails on `sizes`, and the live-but-outside-a-query form fails on `breakpoints`. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-06 08:16:13 +00:00
Marcos Paulo	12c32d2fd7	fix: port the full-guide responsive rules into their components verify-and-publish / gate (push) Successful in 7m20s Details verify-and-publish / publish (push) Has been skipped Details Merges refactor/task-15e-responsive-css. The Astro build imported responsive.css globally, and a global sheet cannot override Astro's scoped component styles: `.tree-node` (0,1,0) loses to `.tree-node[data-astro-cid-lsutp3lb]` (0,2,0). The responsive layer has been partly inert in the build for as long as it has been imported. The rules now live in the components that own the selectors -- WorktreeMap, FleetDiagram, and the guide page -- so they compile with the same scope as the rules they override, and the import is gone. Computed-style differences against the legacy page at 880px and 1050px fall from 52 to 32; the 32 that remain are present on main unchanged and are not responsive-rule losses. Rendered text is untouched: en 432/432, pt 431/431. responsive.css itself is unchanged and full-guide/index.html still links it. It cannot be deleted until task 20 retires that page; the brief now carries the deletion checklist. Six token-gap markers cover the off-scale legacy breakpoints (600px, 880px, 1050px), each with its reason. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-06 03:48:57 +00:00
Marcos Paulo	5c76a13b4d	docs: record responsive css task status Mark only the completed port, reference-removal, and gate checks. Leave screenshot review unchecked because valid full-page comparison artifacts could not be completed in this environment.	2026-09-06 03:45:41 +00:00
Marcos Paulo	91e8d380d0	fix: port full-guide responsive rules Move the Astro-facing responsive layer out of responsive.css, retaining the exact legacy stylesheet for full-guide/index.html until task 20. Scope worktree and fleet overrides to their components so they can win against component base styles. Do not delete responsive.css: the legacy page still loads it. Generated screenshot artifacts are deliberately untracked.	2026-09-06 03:44:42 +00:00
Marcos Paulo	0a12e9cbcc	docs: 15e attempt 4 ported the rules where they cannot win verify-and-publish / gate (push) Successful in 12m46s Details verify-and-publish / publish (push) Has been skipped Details The 880px and 1050px media queries are in the built sheet and inert: Astro's scoped `.tree-node[data-astro-cid-...]` outranks a rule ported verbatim as `.tree-node`. Attempt 4 got everything else right and passed the acceptance test in this brief, which was mine to get wrong. Replaces that test with computed-style-diff.mjs, and records the finding it produced: main is already at 52 differences, because importing a global responsive.css into an Astro page never fully worked either. Tagged rejected/15e-attempt-4. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-06 03:29:28 +00:00
Marcos Paulo	e3ce8abe89	test: diff computed styles, because a ported rule can be inert A media query can sit in the built stylesheet, match the viewport, and do nothing. Astro scopes a component's rules as `.tree-node[data-astro-cid-lsutp3lb]`, specificity 0,2,0. A responsive rule that arrives unscoped as `.tree-node`, 0,1,0, loses to it. The breakpoint is present, the selector matches, the declaration never wins. Task 15e attempt 4 shipped exactly that: `@media (max-width: 1050px) .tree-node { width: 145px }` is in dist and the node stays 180px. The acceptance test I had written for that task -- diff the breakpoints in responsive.css against the breakpoints in the built CSS -- passes on it. Checking that a value appears in a stylesheet cannot catch this; only asking the browser what it computed can. This walks both pages at a list of widths and compares computed styles for every element matching the classes the legacy responsive layer moves at a breakpoint. node .agents/scripts/computed-style-diff.mjs full-guide node .agents/scripts/computed-style-diff.mjs full-guide --widths 880,1050 It reports 52 differences on main at 880px and 1050px, before task 15e changes anything: importing responsive.css into an Astro page never fully worked, for the same specificity reason. The responsive layer has been partly inert in the build for as long as it has been imported. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-09-06 03:29:01 +00:00
		`@@ -1 +0,0 @@`
			<!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>