Karpathy CLAUDE.md — 82.9K stars pour 4 regles de coding LLM¶
Resume¶
Un fichier CLAUDE.md base sur les observations d'Andrej Karpathy atteint 82.9K stars GitHub en 7 jours — #1 trending. MIT license. 4 regles comportementales pour corriger les defauts recurrents des LLM en coding :
- Think before coding : demander clarification au lieu de deviner silencieusement, exposer les tradeoffs, s'arreter quand confus
- Simplicity first : code minimum viable, pas de features speculatives, pas d'abstractions prematurees
- Surgical changes : ne modifier que ce qui est demande, respecter le style existant, ne supprimer que le code orphelin cree par les changements
- Goal-driven execution : transformer les instructions en criteres de succes verifiables, boucler sur la verification
Installation : plugin Claude Code marketplace ou fichier direct dans le projet.
Analyse critique¶
Les 4 regles sont justes. Elles adressent les vrais problemes : assumptions silencieuses, over-engineering, modifications non sollicitees, absence de verification. Ce sont les memes observations que celles documentees dans le thread #9 (over-engineering par l'IA, biais sycophantique).
Ce qui est remarquable, c'est le ratio impact/complexite. 82.9K stars pour un fichier Markdown de ~50 lignes. Ca prouve que le probleme est reel et massivement ressenti. Ca prouve aussi que la solution est simple — des regles claires dans un system prompt, pas un framework.
Ce qui manque : - Pas de mecanisme d'enforcement. Un CLAUDE.md est lu une fois au debut de la session. Sur une longue session, les regles se diluent (exactement le probleme adresse par le thread #1 — cerveau positronique / hooks) - Pas de versioning, pas de metriques de conformite - Pas de separation des roles (le meme agent produit et s'auto-juge)
La vraie lecon : Karpathy valide massivement l'approche "regles architecturales > prompting". C'est exactement la these du thread #1 et du systeme constitutionnel ProbatioVault.
Pertinence ProbatioVault¶
ProbatioVault fait deja tout ca, et plus :
| Karpathy CLAUDE.md | ProbatioVault |
|---|---|
| 4 regles dans un fichier statique | 8 articles constitutionnels (CONSTITUTIONAL.md) + hooks dynamiques |
| Lu une fois au demarrage | Reinjecte a chaque message (UserPromptSubmit hook) |
| Pas d'enforcement | Violation detectee → arret immediat du workflow |
| Pas de metriques | Score de gate deterministe, traçabilite YAML |
| Meme agent produit + juge | Separation Art. II (auteur ≠ evaluateur) |
Pas d'action technique a mener — le systeme en place est plus avance. Mais ce repo est une validation sociale massive (82.9K stars) de l'approche. Excellent materiel a citer dans les threads X : "82K devs sont d'accord que des regles architecturales valent mieux que du prompting — voici comment je l'ai implemente il y a 3 mois (thread #1)."