Lire le post de Marcos Hernanz sur X
Un reel de @ii.systema affirme qu'un développeur a brûlé 60 milliards de tokens, puis a publié le fichier de règles qu'il utilise pour coder avec l'IA. Selon le reel, ce fichier pousse le modèle à chercher des solutions simples, à lire la documentation et à économiser vos limites d'utilisation.
Le développeur s'appelle Marcos Hernanz. Il a travaillé sur Next.js chez Vercel. Le 2 août 2026, il a publié sur X : « After doing ~60B tokens, this is my full AGENTS.md ». Le post montrait sept règles. Quelques heures plus tard, il a ajouté une huitième règle en réponse, avec les mots « Almost forgot ».
Ce qu'est un AGENTS.md
AGENTS.md est un simple fichier texte placé dans le dossier principal d'un projet. Les agents de code le lisent avant de commencer, vous écrivez donc vos règles une seule fois au lieu de les répéter dans chaque conversation. Claude Code le lit quand le projet n'a pas de fichier CLAUDE.md.
Les huit règles, en mots simples
- Ne gardez pas le vieux code en vie. Quand quelque chose est remplacé, supprimez l'ancien chemin. N'ajoutez pas de solutions de repli ni de couches pour le faire fonctionner.
- Choisissez la solution la plus simple qui fait entièrement le travail aujourd'hui. N'ajoutez pas de réglages ni de couches « au cas où ».
- Avancez par petites étapes. Construisez d'abord la plus petite version qui fonctionne du début à la fin. Ajoutez ensuite une fonction à la fois, sur une base qui fonctionne déjà.
- Gardez les parties séparées. Chaque partie fait un seul travail.
- Utilisez une bonne bibliothèque connue quand elle rend les choses plus simples ou plus fiables. Ne réécrivez pas des fonctions courantes sans raison.
- Vérifiez ce que le projet contient déjà avant d'ajouter un paquet ou d'écrire votre propre code. Lisez la documentation et les types de la bibliothèque avant de décider qu'elle ne sait pas faire quelque chose.
- Décidez pour le long terme. Pas de solution rapide destinée à être jetée plus tard.
- Avant de concevoir quelque chose, regardez comment de bons produits établis résolvent le même problème. Reprenez leurs modèles éprouvés au lieu d'inventer les vôtres.
Pourquoi cela peut économiser des tokens
La plupart de ces règles demandent à l'agent d'écrire moins : pas de couches en trop, pas de copies de bibliothèques, pas de code gardé seulement pour d'anciennes versions. Moins de code, c'est moins à lire, à corriger et à expliquer au tour suivant. La règle six est celle que le reel appelle « lire la documentation ». Marcos ne donne aucun chiffre sur le nombre de tokens que le fichier fait économiser.
Un avertissement de l'auteur
Marcos a ajouté une note sous son post : il n'utilise ce fichier que pour des projets personnels, et il ne faut pas l'utiliser en production si vous ne voulez pas détruire votre base de code. La première règle est la plus risquée. Dans un vrai produit, supprimer d'anciens chemins peut casser l'usage de ceux qui en ont encore besoin.
Comment l'utiliser
Créez un fichier nommé AGENTS.md dans le dossier principal de votre projet. Copiez les huit règles de ses deux posts, et modifiez celles qui ne conviennent pas à votre projet. Si vous utilisez Claude Code et avez déjà un CLAUDE.md, ajoutez-y une ligne pour que Claude lise les deux :
@AGENTS.md