Usuario de Reddit comparte enfoque basado en especificaciones para reducir las alucinaciones de código en Claude

Un desarrollador en la comunidad r/ClaudeAI de Reddit compartió un método práctico para reducir las alucinaciones al usar Claude Code en sesiones de desarrollo prolongadas. El enfoque se centra en mantener el contexto mediante documentación estructurada.

El problema: Pérdida de contexto durante las compactaciones

El desarrollador describió un patrón en el que Claude Code comenzaba fuerte en un proyecto pero se degradaba después de múltiples compactaciones de contexto. Instrucciones específicas como "no digas hecho a menos que hayas creado una prueba y la prueba haya pasado" se olvidaban después de las compactaciones, haciendo que errores antiguos reaparecieran y la calidad de la salida empeorara.

La solución: Desarrollo guiado por especificaciones

Inspirado por cómo Anthropic construyó su función de Plugins, el desarrollador adoptó un enfoque primero-especificación:

• Comenzar pidiendo a Claude que haga preguntas aclaratorias sobre la aplicación, luego crear un REQUIREMENTS.md con requisitos detallados en viñetas
• Crear un IMPLEMENTATION_PLAN.md con tareas para cada requisito, haciendo referencia a las viñetas del documento de requisitos
• Crear un plan de pruebas que coincida al 100% con el plan de implementación con casos de prueba para cada tarea
• Crear un CLAUDE.md con instrucciones para referirse al plan de implementación y ejecutar los pasos

El CLAUDE.md instruye específicamente a Claude a:

referirse al plan de implementación y ejecutar los pasos en él. Después de que cada tarea haya completado el desarrollo, debes ejecutar el elemento correspondiente del plan de pruebas para la tarea y solo después de que la prueba pase, debes "debes" marcarla como completa. Para cada nueva instrucción que te proporcione, necesitas actualizar el documento de requisitos, el plan de implementación y el plan de pruebas.

Resultados

El desarrollador reportó una calidad de ejecución mucho mejor incluso después de varias compactaciones. Claude ya no pierde su lugar después de las compactaciones y sabe desde dónde ejecutar. El desarrollador puede preguntar "¿Qué queda?" y obtener respuestas útiles, con una reducción significativa de alucinaciones.

Una limitación señalada: Claude todavía no ejecuta pruebas cada vez, lo que el desarrollador atribuye a las limitaciones de su entorno local (Mac antiguo, dificultad para ejecutar XCode o simuladores).

Claude también creó un archivo MEMORY.md durante el proceso, aunque el desarrollador señaló que no sabe cómo esto es útil.