Bases de code prêtes pour agents : Règles négatives, noms précis, READMEs de répertoire

Un développeur sur r/ClaudeAI a détaillé comment il a adapté sa base de code Android après que Claude Code ait systématiquement ajouté de nouvelles fonctionnalités dans une classe monolithique UserManager (authentification, sessions, profil, analytics). Le constat clé : l'agent arrive à chaque fois sans mémoire, comme un nouveau stagiaire le premier jour, ignorant les décisions architecturales. La solution a été d'ajouter des règles explicites dans un fichier CLAUDE.md à la racine du dépôt.

Trois modèles qui ont fait la plus grande différence

1. Les règles négatives sont plus efficaces que les positives

Au lieu de « suis une bonne conception », le développeur écrit des instructions comme :

Ne touche PAS à BaseActivity – elle est partagée entre 12 fonctionnalités et casse silencieusement.

L'agent est optimiste par défaut et prend le chemin de moindre résistance. Interdire explicitement les chemins dangereux arrête plus efficacement les mauvaises décisions qu'une directive vague.

2. Les noms comptent plus que vous ne le pensez

Une classe nommée UserSessionExpiryHandler est un contrat. La nommer simplement Handler est du bruit. L'agent se base fortement sur les noms pour ses correspondances ; de bons noms réduisent la quantité de lecture de fichiers nécessaire. Le développeur recommande d'éviter les suffixes génériques et de rendre l'objectif explicite dans le nom.

3. Chaque répertoire contient un README listant ce qui n'appartient PAS à ce dossier

Au lieu de « ce dossier est pour l'interface utilisateur », le README indique :

Pas de logique métier dans presentation/

Cette formulation négative « semble mieux fonctionner » sur l'agent, empêchant plus de mauvais placements qu'une orientation positive.

Règles pratiques pour CLAUDE.md

• Gardez les fichiers petits. Une classe, une responsabilité.
• Créez un nouveau fichier plutôt que d'étendre un ancien.
• Ne produisez pas de monolithes – divisez les préoccupations tôt.

Le développeur rapporte qu'après l'application de ces règles, le schéma où l'agent relisait un fichier de 600 lignes trois fois en une session a pratiquement disparu. Il soupçonne que le coût en tokens a considérablement baissé, sans l'avoir mesuré formellement.

À qui cela s'adresse

Développeurs utilisant des agents de codage IA (Claude Code, Copilot, etc.) qui souhaitent réduire le gaspillage de tokens et empêcher les agents de prendre de mauvaises décisions architecturales.