Je suis tombée sur un état d’échec vraiment intéressant.
Voyez-vous, il s’avère que votre propre documentation peut revenir d’entre les morts pour vous mordre.
Laissez-moi vous expliquer.
J’ai deux morceaux d’un même système que je suis en train de construire. Deux systèmes d’agents.
Le premier, c’est Pillowfort : en gros, une troupe de théâtre d’agents orchestrée, réglée pour créer et gérer des entreprises bien réelles.
Le second, c’est Qwench.
Qwench est un bac à sable où je peux faire deux choses :
1. Déterminer si je peux transformer Qwen3.5 9B en un agent de code local capable, tournant sur un PC gaming de cinq ans, sans perdre la discipline de processus ou les capacités qu’on attend d’un agent de code CLI.
Je pense que c’est possible.
J’en suis même presque sûre. C’est un modèle de moins de 50B capable de raisonner sur le fait qu’il est évalué. C’est un point de départ prometteur pour en faire un codeur.
2. Expérimenter des fonctionnalités et des workflows que je ne peux pas tester sans risque dans le système plus large.
Pillowfort n’est plus un build expérimental. C’est un produit. Quelque chose que des gens normaux devraient pouvoir utiliser à terme.
Qwench me permet de combler ce fossé. Ça me donne l’espace pour me planter et développer de nouveaux composants sans avoir à gérer un système auto-générateur, des moteurs de règles, des couches de sécurité, des bizarreries de gestion de contexte et tous les garde-fous bureaucratiques que j’ai écrits pour garder cette machine de Gödel fonctionnelle.
Mais le processus de développement a révélé un truc intéressant.
Les deux projets puisent dans deux ans de recherche et des centaines de milliers de lignes de code. À un moment donné, j’ai commencé à réutiliser d’anciens repos au lieu de tout reconstruire de zéro à chaque itération.
C’était l’idée de Sam. Mon business manager et mon âme sœur spirituelle pour ce genre de choses.
Le problème, c’est que je documente tout.
Aggressivement.
Et la documentation, c’est de l’infrastructure.
D’habitude.
Sauf quand on utilise ses vieux dépôts comme pièces détachées.
C’est là que ça devient délicat.
Parce que si on ne fait pas attention, la documentation de projets sans rapport... là où on n’emprunte qu’un bout par-ci ou un composant par-là... peut faire dérailler vos agents de code.
Quand on utilise des générateurs de code IA pour construire des générateurs de code IA, la documentation cesse d’être du texte passif dans votre repo.
Elle devient une partie de la surface d’instruction.
Vos agents la lisent.
Ils la traitent comme de l’architecture.
Ils la suivent, même quand elle n’est plus sur la roadmap.
En d’autres termes :
La vieille doc ne se contente pas de rester là.
Plutôt, ça pourrait commencer à orienter le système.
Bon à savoir.