SDLC COM AGENTES
Desenhar o Fluxo de Engenharia Desenvolvimento com agentes não é "pedir à IA para construir a aplicação". É o desenho deliberado de contexto, restrições, permissões, ciclos de feedback, pontos de controlo, verificação independente, regras de escalada e responsabilidade ao longo de todo o ciclo de vida, sem abdicar do critério de engenharia.
O CICLO DE VIDA COMO SISTEMA LIGADO · SELECCIONE UMA FASE
DESCOBERTA REQUISITOS PESQUISA ARQUITECTURA PLANEAMENTO CÓDIGO TESTES REVISÃO DEPURAÇÃO SEGURANÇA DOCUMENTAÇÃO PUBLICAÇÃO MONITORIZAÇÃO MANUTENÇÃO RETROSPECTIVAS
Descoberta Enquadrar o problema antes de qualquer agente o ver. Os agentes ajudam a analisar trabalho anterior e concorrentes; a decisão sobre o que merece ser construído permanece humana.
QUEM DETÉM A RESPONSABILIDADE NESTA FASE
HUMANO
AGENTE DE IMPLEMENTAÇÃO
AGENTE DE REVISÃO
AGENTE DE PESQUISA
TESTES / VALIDAÇÃO
CI/CD E PRODUÇÃO
ONDE OS AGENTES FALHAM O fluxo existe porque estes modos de falha são previsíveis. Cada um é um percurso terminado na lattice: observado, nomeado e considerado no desenho.
APIs, opções e comportamentos que nunca existiram, apresentados com total certeza. ⟲ MITIGAÇÃO Verificar em fontes reais: documentação, código e sistemas em execução, nunca na memória do agente. Alegações sem evidência são pistas, não factos. ⟲ Virar para ver a mitigação Estruturas que satisfazem o pedido mas ignoram o sistema à sua volta. ⟲ MITIGAÇÃO Revisão arquitectural adversarial antes de qualquer código: um segundo agente, ou o humano, ataca a proposta até esta considerar o sistema completo. ⟲ Virar para ver a mitigação Melhorar o ficheiro à custa da base de código. ⟲ MITIGAÇÃO Âmbito explícito em cada tarefa, mais um revisor instruído a ler para além do diff e a verificar os consumidores do que mudou. ⟲ Virar para ver a mitigação Sessões longas esquecem silenciosamente restrições anteriores. ⟲ MITIGAÇÃO Sessões curtas e delimitadas com documentos de passagem deliberados. Comprimir o contexto de propósito antes de o agente o perder por acidente. ⟲ Virar para ver a mitigação Reescrever código funcional porque reescrever é mais fácil do que ler. ⟲ MITIGAÇÃO Permissões de escrita apenas em ficheiros nomeados. Tudo o resto é só de leitura por defeito. Uma reescrita tem de ser pedida, nunca presumida. ⟲ Virar para ver a mitigação "Os testes passam" porque foram enfraquecidos até passarem. ⟲ MITIGAÇÃO Validação independente que o agente autor não pode alterar: execuções de testes separadas, ficheiros de teste protegidos e um revisor que também analisa o diff dos testes. ⟲ Virar para ver a mitigação Dez chamadas a ferramentas quando uma pesquisa bastaria: custo, ruído e latência. ⟲ MITIGAÇÃO Observar os rastos regularmente e simplificar o fluxo. Dar aos agentes atalhos determinísticos mais baratos e instruções sobre quando os usar. ⟲ Virar para ver a mitigação Alterações que funcionam localmente e quebram um consumidor que ninguém mencionou. ⟲ MITIGAÇÃO Documentação de integração no repositório e mapas de dependências como contexto permanente, para cada sessão saber o que depende de quê antes de editar. ⟲ Virar para ver a mitigação Segredos nos registos, valores permissivos por defeito e construção de strings vulnerável a injecções. ⟲ MITIGAÇÃO Análise determinística e revisão humana em todas as alterações relevantes para segurança. A auto-avaliação do agente nunca é aceite como evidência. ⟲ Virar para ver a mitigação O utilizador está errado e o agente avança educadamente na mesma. ⟲ MITIGAÇÃO Um passo explícito de desafio cuja única função é discordar: um agente instruído a encontrar o que está errado, não a ser prestável. ⟲ Virar para ver a mitigação