Pare de "Vibe Coding": Por que Contexto é a Nova Inteligência (Apresentando o Método APDC)
Se você é dev e está tentando integrar IA no seu fluxo de trabalho, já passou por isso:
você abre o chat, pede uma feature complexa, e a resposta é um código que parece certo, mas que alucina bibliotecas inexistentes ou quebra todo o seu build.
A comunidade chama isso de "Vibe Coding", codar com base na vibração, na tentativa e erro. Mas sejamos honestos: para engenharia de software séria, "vibe" não compila.
A Vercel recentemente descobriu que agentes de IA falham em usar suas ferramentas em 56% das vezes por simples fadiga de decisão. O problema não é o modelo ser "burro", é o contexto ser caótico.
Foi para resolver isso que desenvolvi o APDC, um framework de Engenharia de Contexto inspirado no clássico PDCA, mas adaptado para a era dos LLMs e Agentes Autônomos.
O Que é o APDC?
APDC significa Análise, Planejamento, Execução (Do) e Controle (Check). (PDCA é um acrônimo para Plan, Do, Check, Act, que é um ciclo de melhoria contínua que se baseia em quatro pilares: Planejamento, Execução, Controle e Análise.)
A grande diferença aqui não é o acrônimo, mas como você interage com a IA em cada etapa. O segredo? Isolamento de Contexto.
1. Análise (Analyse): O Fim da Adivinhação
O maior erro dos devs é abrir um chat e já pedir código. O agente não sabe onde está, que versão do Next.js você usa ou como é a sua estrutura de pastas.
No APDC, a Análise é determinística.
- Como fazer: Peça para o agente analisar o contexto atual do erro ou da feature. Se for um bug, use os "5 Porquês".
- A Chave: O agente não deve criar nada aqui, apenas ler o seu
AGENTS.mdou index do projeto e diagnosticar o cenário. - Resultado: Um documento de análise claro sobre o estado atual.
Fique a vontade para reescrever isso até ele identificar apenas os arquivos que precisap para o contexto.
2. Planejamento (Plan): Retrieval-Led Reasoning
Aqui está o "pulo do gato": Crie um NOVO chat.
Por que? Quando você mantém o histórico da análise, o contexto fica poluído. Limpe a mesa.
- Como fazer: No novo chat, alimente o agente com o documento de Análise gerado no passo anterior.
- O Comando: "Com base nesta análise, crie um plano de execução técnica detalhado."
- Técnica: Se a tarefa for complexa (microsserviços, múltiplas dependências), peça para quebrar o plano em Blocos de Implementação. O agente deve listar quais arquivos ele precisa ler e quais ele vai alterar.
Isso é o que chamamos de Raciocínio Guiado por Recuperação (Retrieval-Led). O plano não é uma alucinação criativa, é um roteiro baseado nos arquivos reais do seu projeto.
3. Execução (Do): Codando com 100% de Precisão
Novamente: Crie um NOVO chat.
Agora o agente tem um propósito único: executar o plano aprovado. Ele não precisa "pensar" sobre a arquitetura (já foi feito no Planejamento) nem "investigar" o problema (já foi feito na Análise).
- Como fazer: Entregue o Plano de Execução para o agente.
- O Comando: "Leia o plano de execução e APENAS execute o Passo 1."
- Por que funciona: A Vercel atingiu 100% de pass rate em testes quando forneceu um contexto estruturado (como um
AGENTS.md) em vez de deixar o agente "explorar". Você remove a incerteza. A execução vira uma consequência óbvia do planejamento.
4. Controle (Check): A Base de Conhecimento
O código rodou? Ótimo. Mas o APDC não acaba no commit.
- Como fazer: Valide se o resultado atende aos requisitos. Se houve erro, o "patch" entra na sua base de conhecimento.
- Loop de Feedback: Crie uma estrutura de pastas para guardar essas Análises e Planos. Com o tempo, seu agente "aprende" sobre o projeto não porque ele tem memória infinita, mas porque você construiu uma base de conhecimento (Knowledge Base) que ele consulta na etapa de Análise do próximo ciclo. Outro ponto importante aqui, é quando for salvar o check, considere salvar os motivos que tomou aquela decisão, considerando os 5 por quês.
Conclusão: "Análise não é busca, é reconhecimento"
A era do "Prompt Engineering" (ficar tunando frases até a IA acertar) está acabando. Estamos entrando na era da Engenharia de Contexto.
O APDC força você a tratar a IA não como um mago criativo, mas como um engenheiro júnior que precisa de especificações claras.
- Análise dá os olhos.
- Planejamento dá o mapa.
- Execução dá as pernas.
- Controle dá a memória.
Pare de pedir para seu agente ser "inteligente". Comece a dar a ele o contexto certo.
Você já usa alguma estrutura parecida com seus agentes? Comenta aí como você lida com alucinações de contexto.