Développement Guidé par Manuel : Une Méthode pour Prévenir la Dérivation Confiante du Code Claude

Le développement piloté manuellement (MDD) est une méthodologie conçue pour résoudre la divergence confiante dans Claude Code, où l'IA produit un code incorrect qui compile et passe ses propres tests parce qu'elle travaille à partir d'hypothèses erronées sur le système.

Le problème : la divergence confiante

Lorsque Claude Code travaille sur de grandes bases de code en production, il lit quelques fichiers, infère des modèles et commence à coder sur la base d'hypothèses. Cela conduit à une divergence confiante - un code qui semble correct, s'exécute, passe les tests, mais est erroné parce que Claude a écrit des tests contre ses hypothèses plutôt que contre le comportement réel du système. La divergence ne se manifeste qu'en production lorsque de vrais utilisateurs rencontrent des cas limites que Claude ne connaissait pas.

L'auteur note que ce n'est pas seulement une question de Claude ne connaissant pas votre système - c'est aussi que les développeurs ne peuvent pas non plus décrire de manière fiable l'ensemble de leur système. À 23 heures, vous ne vous souviendrez pas de mentionner que les opérateurs sont limités à des groupes spécifiques, que ROLE_HIERARCHY est défini dans trois fichiers différents, ou que les politiques de niveau de base sont réservées au système et ne peuvent pas être créées via l'API.

Résultats du MDD en production

Lors d'un audit de production utilisant le MDD :

• Sept sections auditées
• 190 problèmes identifiés
• 876 nouveaux tests écrits
• 7 heures et 48 minutes de temps de session Claude Code
• Entre 234 et 361 heures de temps de développeur humain estimées économisées (ratio de compression de 30 à 46 fois)
• Zéro violation des règles CLAUDE.md dans toutes les sections

La base de code comportait plus de 200 routes, plus de 80 modèles et un pipeline d'exécution de démon qui convertit les politiques réseau en règles nftables actives sur l'hôte.

Comment le MDD diffère des autres outils

Le MDD traite un problème différent des outils existants :

• GSD résout la dégradation contextuelle (détérioration de la qualité à mesure que les sessions se remplissent)
• Mem0 et Claude-Mem résolvent l'amnésie de session (tout oublier lorsque les sessions se terminent)
• MDD résout la divergence confiante (code erroné basé sur des hypothèses incorrectes)

Les trois peuvent fonctionner ensemble sans conflit. RuleCatch, qui surveille l'application des règles en temps réel, a signalé 60 % de violations de règles en moins lors de la construction de SwarmK avec le MDD par rapport aux sessions sans MDD - même modèle, mêmes règles, même base de code.

La méthodologie, les invites et les données section par section sont documentées et reproductibles selon la source.