refactor: cut over to the Astro build
verify-and-publish / gate (push) Successful in 7m30s
verify-and-publish / publish (push) Has been skipped

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>
This commit is contained in:
Marcos Paulo
2026-09-06 08:31:33 +00:00
58 changed files with 372 additions and 1292 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>"
]