Desenvolvimento Guiado por Manual: Um Método para Prevenir a Divergência Confiante do Código Claude

O Desenvolvimento Orientado por Manual (MDD) é uma metodologia projetada para resolver a divergência confiante no Claude Code, onde a IA produz código incorreto que compila e passa em seus próprios testes porque está trabalhando com suposições incorretas sobre o sistema.

O Problema: Divergência Confiante

Quando o Claude Code trabalha em grandes bases de código de produção, ele lê alguns arquivos, infere padrões e começa a codificar com base em suposições. Isso leva à divergência confiante - código que parece correto, executa, passa nos testes, mas está errado porque o Claude escreveu testes contra suas suposições em vez do comportamento real do sistema. A divergência só aparece em produção quando usuários reais encontram casos extremos que o Claude nunca soube que existiam.

O autor observa que isso não é apenas sobre o Claude não conhecer seu sistema - é que os desenvolvedores também não conseguem narrar de forma confiável todo o seu sistema. Às 23h, você não vai se lembrar de mencionar que os operadores são limitados a grupos específicos, que ROLE_HIERARCHY é definido em três arquivos diferentes, ou que as políticas de nível básico são apenas do sistema e não podem ser criadas via API.

Resultados do MDD em Produção

Em uma auditoria de produção usando MDD:

• Sete seções auditadas
• 190 descobertas identificadas
• 876 novos testes escritos
• 7 horas e 48 minutos de tempo de sessão do Claude Code
• Estimativa de 234 a 361 horas de tempo de desenvolvedor humano economizadas (taxa de compressão de 30-46x)
• Zero violações de regras CLAUDE.md em todas as seções

A base de código tinha 200+ rotas, 80+ modelos e um pipeline de aplicação de daemon que converte políticas de rede em regras nftables ativas no host.

Como o MDD Diferencia de Outras Ferramentas

O MDD aborda um problema diferente das ferramentas existentes:

• GSD resolve a deterioração de contexto (degradação da qualidade à medida que as sessões se enchem)
• Mem0 e Claude-Mem resolvem a amnésia de sessão (esquecer tudo quando as sessões terminam)
• MDD resolve a divergência confiante (código errado baseado em suposições incorretas)

Todos os três podem funcionar juntos sem conflito. O RuleCatch, que monitora a aplicação de regras em tempo real, relatou 60% menos violações de regras durante a construção do SwarmK com MDD em comparação com sessões sem MDD - mesmo modelo, mesmas regras, mesma base de código.

A metodologia, os prompts e os dados seção por seção estão documentados e são reproduzíveis de acordo com a fonte.