Sous-agents sur un build de site: déléguez la mesure, gardez les décisions

La limite que vous atteignez sur un gros build n'est pas la capacité de l'agent. C'est le contexte. Une session qui a lu quarante fichiers, trois journaux de build et un sitemap a dépensé l'essentiel de sa fenêtre sur de la matière qu'elle ne reconsultera jamais, et la qualité décroche bien avant que la fenêtre soit pleine. Les sous-agents existent précisément pour cela, et sur un site de quelques centaines de pages ils font la différence entre une bonne journée et trois médiocres.

Ce qu'est réellement un sous-agent

Un sous-agent est un agent distinct avec sa propre fenêtre de contexte, son propre prompt système, son propre accès aux outils et ses propres permissions. Vous déléguez une tâche, il travaille isolé, et il renvoie un résumé. L'exploration n'entre jamais dans votre conversation. La documentation des sous-agents liste ceux fournis d'office, et deux valent d'être connus par leur nom: un explorateur en lecture seule, écritures refusées, et un généraliste avec tout l'outillage.

Ce que l'on rate souvent: il ne s'agit pas de parallélisme pour la vitesse. Il s'agit d'isolation pour la qualité. Un sous-agent qui lit trente fichiers et rapporte une réponse a protégé votre conversation principale de vingt-neuf fichiers de bruit, et c'est le bénéfice même si rien n'a tourné en parallèle.

La quatrième est la plus subtile et la plus précieuse. Un agent avec qui vous raisonnez depuis une heure tendra à vous donner raison, parce que votre hypothèse est dans son contexte. Confiez le diff à un lecteur neuf sans historique et vous obtenez une lecture non ancrée, la seule qui vaille en revue. L'astuce est de lui donner le code et non votre conclusion.

La tâche qu'il ne faut jamais déléguer

Les décisions de design et de copie. Non parce qu'un sous-agent ne sait pas écrire un paragraphe, mais parce que ce qui rend une page bonne est sa cohérence avec toutes les autres, et la cohérence est précisément ce qu'un contexte isolé ne peut pas voir. Nous l'avons appris sur une série de pages locales: déléguées en parallèle, chacune se lisait bien et l'ensemble se lisait comme cinq auteurs différents, et réparer cela a coûté plus que de les écrire dans une seule fenêtre.

La règle que nous avons retenue: un sous-agent peut collecter, mesurer, vérifier et rapporter, et la conversation principale décide. Tout ce dont la bonne réponse dépend de ce que dit déjà le reste du site reste dans la fenêtre qui voit le reste du site.

La restriction d'outils est le but, pas un effet de bord

Un sous-agent personnalisé est un fichier court avec un en-tête, et le champ qui compte le plus est la liste d'outils. Un agent d'audit privé d'écriture ne peut pas réparer par accident ce qu'on lui a demandé de trouver: vous pouvez donc le lancer en pleine confiance sur un dépôt qui vous tient à cœur. Un agent de revue sans réseau ne peut pas divaguer. L'explorateur fourni d'office interdit les écritures pour exactement cette raison.

Le second champ à régler est le modèle. Chercher, lister et compter n'exigent pas votre modèle le plus capable, et router cela vers un modèle moins cher est la façon documentée de maîtriser ce que coûte une session parallèle. Gardez le modèle fort pour la fenêtre qui décide.

La passation est tout le risque

Un sous-agent ne connaît que ce qui est dans son prompt et vous ne voyez que ce qu'il choisit de rapporter. Les deux bouts perdent du détail, et aucun de vous ne peut dire ce que l'autre a manqué. C'est le coût réel, et il se manifeste par un résumé confiant d'un travail qui n'a pas été fait comme vous le supposiez.

Deux habitudes le contiennent. Rédigez le brief comme à un collègue compétent qui n'a jamais vu le dépôt: nommez les fichiers, dites ce que vous avez déjà écarté. Et demandez des nombres plutôt que des adjectifs: un compte, une liste de chemins, un succès ou un échec par élément. Un rapport que vous pouvez vérifier est un rapport auquel vous n'avez pas à vous fier, la discipline même que défend l'article sur la vérification dans la session principale.

Le parallèle n'est pas gratuit

Chaque sous-agent envoie ses propres requêtes contre les mêmes limites d'usage que votre conversation principale: cinq à la fois, c'est cinq fois la dépense d'un coup. C'est acceptable quand le travail est réellement indépendant, et du gâchis sinon. Le test: voudriez-vous encore la réponse du second agent si le premier revenait propre? Si non, lancez-les en séquence.

Comment nous découpons un site de 210 pages

Ce site compte 210 pages locales, et les seules parties déléguées de ce travail étaient de la mesure: trouver quelles pages partageaient un angle, calculer la similarité entre chaque paire, lister celles sans lien entrant. Tout revenait en nombres. L'écriture, l'attribution des angles et les décisions sur les collisions qui comptaient sont restées dans une seule fenêtre, parce que chacune dépendait de ce que disaient déjà les 209 autres pages. Ce découpage est toute la méthode, et le guide de construction couvre le reste. Si vous préférez tout confier, c'est ce que nous faisons.

Deux notes de périmètre avant de développer cela. Les sous-agents travaillent au sein d'une seule session, et la documentation les distingue des autres dispositifs qui y ressemblent: les agents en arrière-plan pour de nombreuses sessions indépendantes suivies depuis un seul endroit, et les équipes d'agents pour un groupe supervisé. Choisir le mauvais des trois est la façon la plus courante de rendre cela coûteux. Et les instructions avec lesquelles démarre un agent délégué sont celles de votre projet, ce qui fait de l'article sur CLAUDE.md le levier le moins cher sur la qualité du travail délégué.