Depurando la lógica de verificación de compilación de Claude Code: Por qué falla la búsqueda de nombres y la búsqueda de huella estructural lo soluciona

Un desarrollador en r/ClaudeAI informa que Claude Code falló repetidamente al detectar funciones existentes, afirmando que '¿está construido X?' devolvía 'no' cuatro veces en una sola sesión, cada vez que la función ya existía. La causa raíz: el agente buscaba por nombre (palabras clave, sinónimos) en lugar de por huella estructural (rutas, esquemas, herramientas registradas, trabajos programados, decisiones documentadas). Los nombres cambian; los artefactos arquitectónicos no.

El patrón

Preguntar '¿esta función ya está construida?' desencadenaba un seguro 'no, así es como la construiríamos', incluso cuando la función ya estaba parcialmente implementada. Cada vez, el usuario tuvo que insistir para obtener la respuesta real. El desarrollador diagnosticó que el agente sí buscaba, pero usando consultas basadas en vocabulario que omitían código con convenciones de nomenclatura diferentes.

La regla (búsqueda por huella estructural)

La regla sintetizada obliga al agente a buscar por forma, no por nombre. Por ejemplo, en lugar de 'encontrar la función X', pregunta '¿qué herramientas de plugin existen?' o '¿qué rutas, esquemas o trabajos registrados coinciden con esta funcionalidad?'. Esto detecta código previo que una búsqueda por nombre nunca habría encontrado.

Cambio clave: 'Buscar por mejores sinónimos sigue siendo buscar por nombre. La versión de huella lo detecta (el código previo registró una herramienta de plugin, y "¿qué herramientas de plugin existen?" es una búsqueda estrecha de alta señal).'

Comentarios solicitados a la comunidad

• Formas de alucinación que la búsqueda por huella estructural NO detectaría
• Patrones de auditoría de fachada donde se cumple la forma sin sustancia
• Sobre-disparo en preguntas que no son realmente afirmaciones de ausencia
• Amplificación de confianza: después de la auditoría, el agente está más seguro de sus conclusiones, haciendo más difíciles de detectar errores de ontología incorrecta
• Rigor de ontología incorrecta: el agente busca patrones GraphQL en un sistema REST, no encuentra nada, confirma ausencia

El desarrollador está probando la regla en un proyecto separado durante 2-3 semanas antes de considerar una configuración global. Invita a otros a compartir reglas que resolvieron la 'alucinación con rigor' (no solo alucinación).