Por que isso importa
Sem essas travas, um agente pode marcar uma tarefa como “feita” sem que o código exista, escrever uma rota no lugar errado, ou inventar um “QA aprovado” sem rodar nada. O resultado parece pronto e não é. As travas abaixo tornam o “pronto” verificável.As travas
O build roda de verdade
A validação de QA executa o
npm run build (ou o typecheck da stack) e lê o exit code.
Se o build falha, o veredito vira reprovado e o erro real é colado. A palavra do agente
não passa por cima do exit code.Nada de código fantasma
Uma issue de código que conclui sem mudar arquivo nenhum não vira “feita”: ela é marcada
como não verificada, com aviso. Alegar pronto sem diff não conta.
Arquivos no lugar certo
Em projeto Next.js, uma rota fora de
app/ é ignorada pelo framework, então a rota não
existe. A QA reprova arquivos de rota órfãos com a lista do que mover.Base que já compila
Projetos do zero partem dos scaffolders oficiais (Next 15, React 19, Tailwind v4,
shadcn/ui). O setup escala uma vez pro premium, que roda o CLI de verdade, em vez de o
modelo local escrever uma base pela metade.
O contrato da Cápsula
Cada Cápsula carrega um contrato: predicados que a máquina confere após a execução, sem custo de modelo.Os asserts baratos são guard-rails: eles pegam regressão (símbolo sumiu, imports comidos),
não provam comportamento. A prova dura de comportamento é o gate de build no QA, que
roda o build real e reprova se ele quebra.
A máquina de decisão: re-tentar local, escalar premium, concluir
Quando uma execução falha a validação, o erro é re-alimentado e o Forge tenta de novo, agora com o pitfall que casa. Se persiste, escala pro modelo premium, que recebe o histórico (o que tentou, em que tier, qual erro) e re-compila a Cápsula em vez de começar do zero. Só quando o contrato passa a issue é concluída.Onde você vê isso
- Na issue: comentários do sistema marcam reprovações, pitfalls e o veredito de QA.
- No code review: a revisão final no épico confere o conjunto antes do merge.
- Nos logs e observabilidade: cada trava aparece no trace de execução.
Veja também
A Cápsula
Como a intenção vira uma unidade com contrato verificável.
Aprovações
Quando o trabalho precisa do seu OK antes de seguir.