Diego Souza · AI Engineer

Como eu construo com IA

Construído com agentes de código sob um harness de engenharia: spec antes de código, gates, evals, ledgers de orçamento e evidência salva, seguindo as melhores práticas de engenharia de AI. Todo número aqui leva à execução que o produziu.

Do intake ao gateFluxo: Intake, Spec, Plano, Executar, Verificar, GateIntakeSpecPlanoExecutarVerificarGateDo intake ao gateFluxo: Intake, Spec, Plano, Executar, Verificar, GateIntakeSpecPlanoExecutarVerificarGate

O fluxo inteiro. Aperte tocar ou próximo para percorrer.

Versão em texto deste diagrama
  1. Intake Lab. Decisões e um perfil antes de qualquer código.
    • depois Spec
  2. Spec Lab. Uma especificação escrita com ids de requisito.
    • depois Plano
  3. Plano Lab. Caminhos de escrita permitidos e mudanças proibidas são declarados.
    • depois Executar
  4. Executar Lab. Agentes escrevem o código dentro desses caminhos.
    • depois Verificar
  5. Verificar Lab. Comandos rodam, exit codes e saída são salvos.
    • depois Gate
  6. Gate Lab. Sem evidência, o resultado continua incompleto.
Evidência antes de pronto
Um resultado precisa de comando, exit code e saída salva. Sem isso, está incompleto.
Números só de execuções
Métricas, custo e benchmarks vêm de execuções registradas. Sem execução, PENDING.
Teste vermelho é sinal
Corrija a causa raiz. Nunca apague nem enfraqueça o teste para passar.
Efeitos externos autorizados
Sem deploy, publicação, push ou gasto acima do orçamento sem aprovação explícita.
Prompt e tool são código
Vivem no repositório, têm teste de contrato, e toda mudança passa por regressão.
Uma fonte de verdade
Perfil, estado do builder, contrato do agente e métricas de execução têm cada um exatamente um lar.

Declaração de uso de IA

Agentes de código escreveram a maior parte do código deste portfólio. Eu escrevi as specs, defini os caminhos de escrita e os gates, revisei cada diff e decidi o que conta como evidência. Os agentes nunca decidem que algo está pronto.

ai-engineer-lab