O Fim da Programação por Intuição
A era do “Vibe Coding” é um beco sem saída para o profissional. Confiar apenas no instinto da IA, lançando prompts aleatórios, produz dívida técnica imediata. O engenheiro de IA rigoroso utiliza frameworks estruturados para garantir que o software dure. Matt Pocock sistematizou esta abordagem num método de 7 fases que separa o amadorismo da engenharia de precisão.
Da Ideia Versátil ao Cache de Investigação
A jornada começa na Fase 1 (Ideia): definir claramente se o objetivo é uma nova funcionalidade, correção ou refatorização.
Na Fase 2 (Investigação), evita-se o desperdício da janela de contexto criando um cache de conhecimento num ficheiro research.md. Este documento “congela” descobertas sobre APIs e lógica de negócio, mas deve ser gerido para evitar a “podridão” de informação desatualizada.
“Sempre que o vosso agente está a trabalhar, ele pode precisar de explorar o repositório num contexto fresco. Se essa exploração for difícil, devem fazer cache dessa investigação num ativo research.md.”
Validar a Arquitetura e Impor o “Gosto” no Protótipo
Na Fase 3 (Protótipo), o humano impõe a sua visão arquitetural. A IA segue padrões, mas não tem gosto estético. Esta fase utiliza throwaway routes e sessões interativas para testar integrações antes que o custo de mudança suba. O objetivo é fornecer ao agente um exemplo concreto e funcional para seguir.
O PRD “Challenger” e a Precisão do Kanban
Na Fase 4 (PRD - Product Requirements Document), o engenheiro deve pedir à IA que o “interrogue” (grilling), fechando lacunas de design.
Com o PRD validado, segue-se a Fase 5 (Kanban), decompondo a visão em tarefas atómicas. Ferramentas como o Linear são preferíveis para gerir dependências.
A hierarquia é:
- Ideia: O gatilho.
- PRD: Especificação técnica após o “interrogatório”.
- Tickets/Kanban: Tarefas granulares com dependências mapeadas.
Ralph Loops e o Rigor Insubstituível do QA Humano
A Fase 6 (Execução) foca-se no Ralph Loop: um ciclo sequencial que trabalha ticket a ticket. Se as fases anteriores forem rigorosas, esta execução pode ser automatizada (AFK).
O ciclo fecha-se na Fase 7 (QA - Garantia de Qualidade). Embora a IA gere o plano de testes, o veredito final é humano. O QA gera novos tickets, criando um ciclo de melhoria contínua.
A Evolução da Engenharia de IA
A transição para este framework de 7 fases é a evolução necessária. O papel do engenheiro mudou: de quem escreve cada linha para quem desenha o processo, valida a arquitetura e garante a qualidade. O futuro exige rigor, não apenas instinto.