@andreias.ai · checklist

Velocidade vem do processo.

O caminho que levou 605 pull requests à produção em 100 dias num sistema real em produção, um monolito modular. Marque o que o seu time já tem. O que ficar em branco é por onde começar.

01PR para tudo

Nenhuma mudança vai para produção por fora do caminho.

A branch principal não recebe push direto; tudo entra por pull request. Correção pequena e ajuste de texto também passam por PR. Cada PR faz uma coisa só e cabe numa revisão de 15 minutos. A descrição do PR diz o que muda, por quê e como foi testado.

02PRD antes da feature

O agente executa melhor quando o que construir está escrito.

Toda feature nova começa com um PRD: problema, regra de negócio e o que fica de fora. O PRD tem critério de aceite que dá para conferir, não "funcionar bem". Uma pessoa revisa o PRD antes da primeira linha de código. Os PRDs ficam no repositório, junto do código que eles explicam.

03CI que barra

Prova automática antes do merge, não depois do incidente.

Testes, tipos e lint rodam em todo PR. CI vermelho bloqueia o merge, sem exceção "só desta vez". Migration de banco é testada antes de chegar à produção. "Está no ar" só depois de conferir a versão servida em produção.

04Revisor de IA em todo PR

O agente lê primeiro; a pessoa decide.

Um revisor de IA comenta automaticamente cada PR aberto ou atualizado. Ele recebe as regras da casa: o que nunca fazer, onde ficam os segredos. Os apontamentos dele são respondidos ou corrigidos antes do merge. A aprovação final é de uma pessoa, nunca do próprio agente.

05Skills: o caminho guardado

O que funcionou uma vez vira playbook, não memória de alguém.

Deploy, migration e revisão têm passo a passo escrito que o agente carrega. Regra crítica vira trava automática (hook), não lembrete. Quando o agente erra, a correção vira regra para a próxima sessão. Ação com efeito externo (publicar, cobrar, apagar) pede aprovação de uma pessoa.