Un utilisateur de Reddit partage une approche basée sur les spécifications pour réduire les hallucinations de code de Claude.

Un développeur de la communauté r/ClaudeAI de Reddit a partagé une méthode pratique pour réduire les hallucinations lors de l'utilisation de Claude Code pour des sessions de développement prolongées. L'approche se concentre sur le maintien du contexte grâce à une documentation structurée.

Le problème : perte de contexte pendant les compactions

Le développeur a décrit un schéma où Claude Code commençait fort sur un projet mais se dégradait après plusieurs compactions de contexte. Des instructions spécifiques comme "ne pas dire terminé à moins d'avoir créé un test et que le test ait réussi" étaient oubliées après les compactions, provoquant la réapparition d'anciens bugs et la détérioration de la qualité des résultats.

La solution : développement piloté par spécifications

Inspiré par la façon dont Anthropic a construit sa fonctionnalité Plugins, le développeur a adopté une approche "spec-first" :

• Commencez par demander à Claude de poser des questions de clarification sur l'application, puis créez un REQUIREMENTS.md avec des exigences détaillées et en puces
• Créez un IMPLEMENTATION_PLAN.md avec des tâches pour chaque exigence, en référençant les points des puces du document des exigences
• Créez un plan de test qui correspond à 100 % au plan d'implémentation avec des cas de test pour chaque tâche
• Créez un CLAUDE.md avec des instructions pour se référer au plan d'implémentation et exécuter les étapes

Le CLAUDE.md indique spécifiquement à Claude de :

se référer au plan d'implémentation et exécuter les étapes qu'il contient. Après chaque tâche de développement terminée, vous devez exécuter l'élément correspondant du plan de test pour la tâche et seulement après la réussite du test, vous devez impérativement la marquer comme terminée. Pour chaque nouvelle instruction que je vous fournis, vous devez mettre à jour le document des exigences, le plan d'implémentation et le plan de test.

Résultats

Le développeur a rapporté une bien meilleure qualité d'exécution même après plusieurs compactions. Claude ne perd plus sa place après les compactions et sait d'où exécuter. Le développeur peut demander "Que reste-t-il ?" et obtenir des réponses utiles, avec une hallucination significativement réduite.

Une limitation notée : Claude ne lance toujours pas les tests à chaque fois, ce que le développeur attribue aux contraintes de son environnement local (vieux Mac, difficulté à exécuter XCode ou simulateurs).

Claude a également créé un fichier MEMORY.md pendant le processus, bien que le développeur ait noté qu'il ne sait pas comment cela est utile.