Evidência ou fica incompleto
Uma tarefa está pronta quando um comando rodou, o exit code e a saída estão salvos e o diff foi revisado. Sem isso, o resultado é marcado como incompleto.
Descartado: Aceitar a declaração de um agente de que funciona.
O harness de engenharia
O sistema de engenharia que construiu tudo isso com agentes de código.
processo em uso, resultado por projetoÚltima verificação: 2026-10-31 · Commit 7b67edd
Resumo
- Problema
- Agentes de código escrevem rápido e afirmam mais do que checaram. Velocidade sem gate produz trabalho confiante e não verificado.
- Meu papel
- Escrevi as regras, o template de fase e os gates, e reviso o que os agentes produzem.
- Stack
- Markdown specs, Python gates, Git hooks, Conventional Commits
- Resultado
- As regras estão em `AGENTS.md`: nenhum resultado é chamado de pronto sem comando, exit code e saída salva, e um número só vem de uma execução registrada.
Spec antes de código, caminhos de escrita delimitados, gates, evals, ledgers de orçamento e evidência salva para cada afirmação, seguindo as melhores práticas de engenharia de AI. Agentes de código fizeram o volume. O harness é o motivo de o resultado ser confiável, e cada fase está no repositório para leitura.
Veja rodando
O demo ao vivo roda este sistema contra um modelo real e mostra cada passo.
Como funciona
O fluxo inteiro. Aperte tocar ou próximo para percorrer.
Versão em texto deste diagrama
- Intake Lab. Decisões e um perfil antes de qualquer código.
- depois Spec
- Spec Lab. Uma especificação escrita com ids de requisito.
- depois Plano
- Plano Lab. Caminhos de escrita permitidos e mudanças proibidas são declarados.
- depois Executar
- Executar Lab. Agentes escrevem o código dentro desses caminhos.
- depois Verificar
- Verificar Lab. Comandos rodam, exit codes e saída são salvos.
- depois Gate
- Gate Lab. Sem evidência, o resultado continua incompleto.
Decisões
Caminhos de escrita são declarados por plano
Cada plano lista os caminhos que pode mudar e as mudanças que não pode fazer. Uma fase de produto não pode editar o kit compartilhado.
Código: harness/GSD-LITE-PLUS.md
Descartado: Deixar um agente editar o que precisar.
Resultados
Medido
PENDENTE
Não medido, então não afirmado
- O quanto o harness acelera a entrega. Não tenho comparação controlada.
- Se o processo se transfere para um time.
Galeria de falhas
- O que aconteceu
- Um gate completo foi marcado como incompleto após tentativas repetidas.
- Causa
- Um literal antigo em um teste não batia mais com um valor de política que tinha mudado.
- O que mudou
- As tentativas estão registradas, nenhuma chamada live foi feita com gate vermelho, e o valor antigo foi corrigido em tarefa própria.
Valide você mesmo
git clone https://github.com/DiegoVSouza/ai-engineer-lab.git
cd ai-engineer-lab
python scripts/harness/verify.pyEsperado: As checagens estruturais do lab passam.
O que eu faria diferente
Eu versionaria o template de fase e mostraria o diff entre versões, para mudanças de processo serem tão revisáveis quanto mudanças de código.