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>
This commit is contained in:
Marcos Paulo
2026-09-06 08:30:27 +00:00
parent 12c32d2fd7
commit 580293867d
57 changed files with 367 additions and 1287 deletions
+104
View File
@@ -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>"
]