Astuce — savoir ceci suffit pour commander
A l’agent : “Trouve le fichier le plus long et separe par fonction. Nom de fichier = nom de fonction. Tous les tests existants doivent passer.”
A l’agent : “Lance filefunc validate et ramene les violations a 0. Tous les tests existants doivent passer.”
A l’agent : “Repete tsma next en ajoutant des tests a toutes les fonctions. Si des branches non couvertes apparaissent, ajoute aussi ces tests. Jusqu’a All functions complete.”
Go, TypeScript, Python supportes.
Pourquoi commander ainsi
Code lisible par un humain ≠ Code operable par un agent
L’agent charge le fichier entier. 20 fonctions dans un fichier = 19 inutiles = pollution de contexte. Les recherches confirment : informations inutiles reduisent les performances IA de 30 a 85%.
filefunc — 1 fichier, 1 concept
Principe : 1 fichier = 1 concept. Nom du fichier = nom du concept. Verifie sur Hono (23k+ stars) : 186 → 626 fichiers. 4 419 tests, aucun casse.
tsma — ligne de defense du code legacy
tsma next → ecriture du test → feedback avec numeros de lignes non couvertes → couverture → PASS → fonction suivante. L’agent meurt, la progression persiste dans session.json.
4 conditions de l’Agent Operable Codebase
| Condition | Outil | Effet |
|---|---|---|
| 1 fichier = 1 concept | filefunc | Blocage de la pollution de contexte |
| Tests pour toutes les fonctions | tsma | Detection de regression post-modification |
| References symboliques | operationId (yongol) | Tracabilite inter-couches |
| Suppression du couplage implicite | whyso coupling | Detection des dependances cachees |
Message cle du Cours 8 : Ne faites pas le train plus rapide. Posez les rails.
Articles connexes
Cours complet Reins Engineering
| Cours | Titre |
|---|---|
| Cours 1 | Comment commander l’IA |
| Cours 2 | Comment ne pas faire confiance a l’IA |
| Cours 3 | L’application incassable |
| Cours 4 | Les decisions hors du code |
| Cours 5 | L’IA bridee |
| Cours 6 | Passe, verrouille |
| Cours 7 | Retourner la flatterie |
| Cours 8 | L’usine des agents |
| Cours 9 | L’automatisation au-dela du code |
| Cours 10 | La loi des donnees |
Sources
- Stanford, “Lost in the Middle” (2024) — Information pertinente enfouie au milieu : -30%+
- Amazon, “Context Length Alone Hurts LLM Performance” (2025) — Tokens inutiles meme vides : -13,9 a 85%
- Hono : 186 → 626 fichiers, 4 419 tests tous passes
- tsma : 527 fonctions, PASS 246, DONE 281, TODO 0