Le hook Git pre-commit empêche les agents d'IA de codage de commettre avec une documentation obsolète.

Problème : Les agents d'IA de codage commettent du code avec une documentation obsolète

Lorsqu'ils travaillent avec des assistants d'IA de codage comme Claude Code sur plusieurs sessions, les développeurs rencontrent un problème spécifique : l'IA apporte des modifications au code (ajout de routes, refactorisation de composants, renommage d'éléments) mais ne met pas à jour les fichiers de documentation comme ARCHITECTURE.md et README. Cela fait que les sessions suivantes commencent avec l'IA lisant une documentation qui décrit un code datant de plusieurs semaines.

Les conséquences incluent :

• Claude hallucine des noms de fonctions qui n'existent plus
• Référence des points de terminaison d'API qui ont été renommés
• Suggère des modèles qui contredisent l'architecture actuelle

Les avertissements consultatifs ne fonctionnent pas car lorsque Claude effectue un commit, personne ne voit la sortie stderr.

Solution : Un crochet pre-commit bloquant

Le développeur a créé un crochet Git pre-commit avec ce flux de travail :

• Le crochet sait quels changements de fichiers devraient déclencher des mises à jour de documentation (modèles configurables par projet)
• Lorsque Claude Code effectue un commit, le crochet le détecte via les variables d'environnement
• Le crochet évite de tenter de corriger automatiquement la documentation (ce qui provoquerait un blocage en faisant apparaître Claude depuis l'intérieur de Claude)
• Au lieu de cela, il se termine avec le code 1 et affiche un message clair : "la documentation est obsolète, mettez à jour ces fichiers, puis réessayez"
• Claude lit l'erreur, met à jour la documentation, retente le commit, et le commit est accepté

Pour les commits humains, le crochet appelle directement l'API Anthropic et corrige les sections pertinentes (cela prend environ 20 secondes).

Chaque commit génère un fichier session-context.md avec un résumé de l'activité récente afin que la session suivante ait une continuité.

Détails d'implémentation

L'outil est disponible en tant que package npm : @mossrussell/agent-guard

Caractéristiques clés :

• Fonctionne avec Claude Code, Cursor, Windsurf et Copilot
• Zéro dépendance
• Disponible à : https://www.npmjs.com/package/@mossrussell/agent-guard