Un développeur Python dompte Claude Code : une configuration ouverte contre les régressions

Un développeur de CREATMAN a passé plusieurs semaines à étudier la documentation, les discussions sur Reddit et les configurations d'autres développeurs pour assembler une configuration de Claude Code dotée d'une vraie protection contre les régressions. Le résultat : un dépôt ouvert avec des fichiers prêts à l'emploi.

Un problème que tout le monde connaît

Claude Code est puissant, mais sans réglage adapté, il agit avec trop d'autonomie. Le tableau typique pour un développeur solo :

• Vous lui demandez d'ajouter l'authentification, et l'agent réécrit la moitié du projet
• Vous lui demandez de corriger une fonction, et vous récupérez des tests supprimés et une dépendance que personne n'a demandée
• Vous montez un prototype fonctionnel en une heure, puis passez trois heures à démêler les « améliorations » de l'agent

Pour ceux qui travaillent seuls, c'est doublement critique. Pas d'ingénieur QA pour repérer les régressions après chaque prompt. Pas de relecteur pour remarquer les tests supprimés. Chaque modification imprévue coûte du temps passé à décortiquer les choix d'un autre plutôt qu'à travailler sur le produit.

L'auteur dirige CREATMAN sans équipe et s'est heurté précisément à ce problème : l'IA aide à construire vite, mais sans contrôle, elle crée tout aussi vite de nouveaux problèmes.

Ce que contient la configuration

Après plusieurs semaines passées à lire des docs, des discussions de forums et à analyser les configurations d'autres développeurs, l'auteur a retenu cinq composants clés. Tous figurent dans le dépôt claude-code-antiregression-setup et sont prêts à l'emploi :

• CLAUDE.md : le fichier-contrat principal, avec le périmètre de la tâche, des interdictions explicites de décider seul, et l'obligation de décrire les modifications prévues avant de les exécuter
• Règles par répertoire : des restrictions au niveau des dossiers pour que l'agent ne touche pas à ce qu'on ne lui a pas explicitement demandé
• Checklist obligatoire : avant toute modification, l'agent décrit son plan, et le développeur le valide ou le rejette
• Hooks : des scripts automatiques lancés après chaque action de l'agent, qui vérifient sa conformité avec la tâche
• Modèles de prompts : des formats de requêtes prêts à l'emploi qui lèvent l'ambiguïté et réduisent la marge d'interprétation

Point important : tout est documenté. Le dépôt n'est pas fait pour être étudié, mais pour être branché rapidement : on le clone, on l'adapte à son projet, on l'utilise.

Pourquoi un contrat fonctionne mieux qu'une interdiction

L'idée centrale est de donner à l'agent des règles claires plutôt que de simplement le brider. Claude Code lit CLAUDE.md au début de chaque session. Si le fichier indique explicitement « ne touche pas aux tests sans demande », « ne modifie que les fichiers indiqués » ou « préviens avant d'ajouter une dépendance », l'agent s'y conforme.

« J'ai besoin que l'agent IA m'aide à livrer plus vite, pas qu'il crée

de nouveaux problèmes », explique l'auteur.

Les hooks ajoutent un second niveau. De petits scripts s'exécutent après les modifications et vérifient que l'agent n'a pas dépassé les bornes. Si c'est le cas, les changements sont signalés pour relecture au lieu de glisser en silence dans la base de code.

Les modèles de prompts règlent un autre problème. Une requête floue laisse à l'agent trop de marge d'interprétation, et c'est là que commencent les initiatives personnelles. Des formats prêts à l'emploi, qui précisent le périmètre, les fichiers et le résultat attendu, réduisent nettement cette marge.

CLAUDE.md n'est pas qu'un simple README pour l'agent, c'est un document vivant du projet. On y consigne les décisions d'architecture, les modules critiques et les conventions de nommage. L'agent s'appuie sur ce fichier comme contexte à chaque requête, ce qui rend sa compréhension du projet plus précise et les « améliorations » intempestives moins probables.

La configuration n'est pas liée à une stack particulière. L'auteur travaille avec un backend Python, mais les principes s'appliquent à tout projet où il faut garder l'agent dans le cadre de la tâche fixée.

Ce que cela signifie

L'imprévisibilité est l'un des principaux freins à l'adoption des agents IA dans le développement en solo. Des configurations ouvertes comme celle-ci abaissent le seuil d'entrée : on prend la structure, on l'adapte à son projet et on obtient un outil maîtrisable plutôt qu'un assistant chaotique. Plus ces configurations se multiplient en accès libre, plus l'usage d'agents IA sans équipe de support devient praticable.