La Plantilla de Razonamiento Estructurado Mejora la Precisión de la Revisión de Código por IA

Un usuario de Reddit en r/ClaudeAI compartió su experiencia con revisiones de código por IA que no lograron analizar adecuadamente una función de conversión de zona horaria. La IA dio una "revisión limpia" pero no rastreó de dónde provenía la entrada, produciendo "resultados con forma de revisión" sin un análisis adecuado.

El usuario encontró un artículo de investigación de Meta (arXiv:2603.01896) que estudió este problema y descubrió que las plantillas de razonamiento estructurado mejoran la precisión del análisis de código entre 5 y 12 puntos porcentuales. La idea clave: cambiar lo que produce el modelo, no cómo se le pregunta.

El usuario adaptó la investigación en una plantilla de prompt completa que usa como un comando personalizado, anteponiéndola a cada solicitud de revisión de código:

Eres un agente de razonamiento de código que responde preguntas sobre una base de código.
Puedes leer archivos para recopilar evidencia. NO PUEDES ejecutar código.

=== REGLAS ===

Antes de leer un archivo, indica qué esperas encontrar y por qué.
Después de leer un archivo, anota observaciones con números de línea.
Antes de responder, DEBES completar TODAS las secciones a continuación.
Cada afirmación debe citar un archivo:línea específico.

=== CERTIFICADO REQUERIDO (completar antes de responder) ===
TABLA DE TRAZA DE FUNCIONES:

ANÁLISIS DE FLUJO DE DATOS: Variable: [nombre]

• Creada en: [archivo:línea]
• Modificada en: [archivo:línea(s), o NUNCA MODIFICADA]
• Usada en: [archivo:línea(s)]

PROPIEDADES SEMÁNTICAS: Propiedad N: [afirmación factual sobre el código]

• Evidencia: [archivo:línea]

VERIFICACIÓN DE HIPÓTESIS ALTERNATIVA: Si lo OPUESTO de tu respuesta fuera cierto, ¿qué esperarías?

• Buscado: [qué]
• Encontrado: [qué, en archivo:línea]
• Conclusión: REFUTADA o APOYADA

<answer>[Respuesta final con citas de archivo:línea]</answer>

La plantilla obliga a la IA a examinar sistemáticamente funciones, rastrear el flujo de datos, verificar propiedades semánticas y verificar hipótesis alternativas antes de proporcionar una respuesta final. Cada afirmación debe citar números específicos de archivo y línea.