Depurando a lógica de verificação de build do Claude Code: Por que a busca por nome falha e a busca por pegada estrutural a corrige

Um desenvolvedor no r/ClaudeAI relata que o Claude Code repetidamente falhou em detectar recursos existentes, afirmando que "o recurso X está implementado?" retornou "não" quatro vezes em uma única sessão — cada vez que o recurso já existia. A causa raiz: o agente buscava por nome (palavras-chave, sinônimos) em vez de por pegada estrutural (rotas, esquemas, ferramentas registradas, tarefas agendadas, decisões documentadas). Nomes mudam; artefatos arquiteturais não.

O padrão

Perguntar "este recurso já foi implementado?" gerava um confiante "não, aqui está como implementaríamos", mesmo quando o recurso estava parcialmente implementado. Cada vez o usuário precisava contestar para extrair a resposta real. O desenvolvedor diagnosticou que o agente estava buscando, mas usando consultas baseadas em vocabulário que perdiam código com convenções de nomenclatura diferentes.

A regra (busca por pegada estrutural)

A regra sintetizada força o agente a buscar pela forma, não pelo nome. Por exemplo, em vez de "encontrar recurso X", ele pergunta "quais ferramentas de plugin existem?" ou "quais rotas, esquemas ou tarefas registradas correspondem a essa funcionalidade?". Isso captura código anterior que uma busca por nome nunca teria encontrado.

Mudança chave: "Buscar por sinônimos melhores ainda é buscar por nome. A versão por pegada captura o código (o código anterior registrou uma ferramenta de plugin, e 'quais ferramentas de plugin existem?' é uma busca estreita de alto sinal)."

Feedback solicitado da comunidade

• Alucinações que a busca por pegada estrutural NÃO capturaria
• Padrões de auditoria de fachada em que a forma é satisfeita sem substância
• Acionamento excessivo em perguntas que não são realmente alegações de ausência
• Ampliação de confiança: após auditoria, o agente fica mais confiante nas conclusões, tornando erros de ontologia errada mais difíceis de detectar
• Rigor de ontologia errada: agente busca padrões GraphQL em um sistema REST, não encontra nada, confirma ausência

O desenvolvedor está testando a regra em um projeto separado por 2 a 3 semanas antes de considerar uma configuração global. Ele convida outros a compartilhar regras que resolveram 'alucinação com rigor' (não apenas alucinação).