Como trabalho
Uso agentes de código em todas as etapas do ciclo de desenvolvimento, dentro de um processo que mantém o trabalho especificado, delimitado, testado e revisado. O julgamento e a responsabilidade pelo que vai para produção continuam comigo.
O processo
01
Spec primeiro
Toda mudança começa como uma spec escrita: o problema, o escopo, o que fica de fora e como verificar o resultado. Os agentes trabalham a partir da spec, e não de um histórico de chat.
02
Plano e tarefas delimitadas
A spec vira um plano e tarefas pequenas, e cada tarefa é verificada ao terminar, para que um agente só carregue o contexto de que uma tarefa precisa.
03
Implementação por agentes
Agentes de código implementam uma tarefa por vez, dentro das instruções do repositório (AGENTS.md): convenções, comandos e as regras que precisam respeitar.
04
Os mesmos gates para todos
Toda mudança passa pelos mesmos gates, não importa quem escreveu: typecheck, lint, testes unitários e end-to-end, verificações de acessibilidade e checagens do build gerado.
05
Revisão humana
Reviso toda mudança e só faço merge do que consigo explicar. Os achados aceitos voltam para o agente corrigir, e a mudança é revisada de novo.
06
Decisões em ADRs
Decisões que moldam o sistema são registradas como architecture decision records, para que o raciocínio sobreviva à sessão que o produziu.
Onde ver isso
Este site
O repositório público mostra as instruções para agentes, os architecture decision records, os testes e os gates de CI pelos quais toda mudança passa.
sdd-agentic-flow
O processo como um harness open source de skills para Codex, Cursor, Claude Code e GitHub Copilot.
IA em produtos
A mesma regra para funcionalidades com IA: a IA acelera o fluxo, guardrails e pessoas tomam as decisões.