Construction à validation — construction multi-agents contradictoire
Pour un travail où être plausiblement erroné coûte cher. Un agent — même discipliné — ne peut pas détecter ses propres erreurs de manière fiable : l'angle mort qui a produit le bogue examine le bogue. La qualité provient de l'indépendance : un second agent dont le travail est de dire NON-APPROUVÉ, en examinant chaque étape jusqu'à ce qu'elle obtienne un APPROUVÉ explicite.
L'économie : compressez tout ce que les agents lisent (spécifications, notes, invites de contrôle), afin de pouvoir vous permettre un second agent pour contester. L'efficacité finance la redondance.
1. Attribution des rôles
Trois rôles : Orchestrateur (détient le document d'ancrage, attribue les autres, intègre), Auteur (rédige le code/la conception), Relecteur (examine jusqu'à APPROUVÉ). Attribution par tâche, pas par habitude :
| Auteur | Relecteur | Quand |
|---|---|---|
| Agent de pointe (contexte complet du dépôt) | Agent de pointe multi-fournisseur | Constructions à forte conception et à enjeux élevés — le modèle de base |
| Agent CLI externe (par ex. Codex) | Orchestrateur lui-même | Saisie mécanique en vrac ; l'orchestrateur a le contexte + le jugement |
| Modèle local (classe Ollama) | Orchestrateur | Rédaction de fonctions à coût nul à partir d'un cahier des charges précis |
| Sous-agent bas de gamme | Niveau phare | Économie intra-famille : mains bon marché, juge coûteux |
Liaisons d'exécution — chaque attribution nécessite un transport concret dans votre environnement ; utilisez ce qui existe plutôt que d'inventer la plomberie :
- Auteur modèle local → la compétence
rjv-ollama-delegate(exécuteur intégré, règles de rédaction d'invites, obligation de vérification). - Auteur/Relecteur CLI externe (classe Codex) → son plugin d'agent ou un sous-agent de transfert Bash léger (par ex. le sous-agent de sauvetage Codex dans Claude Code) — un appel entrant, stdout en retour, modèle le moins cher possible sur le transfert lui-même.
- Auteur bon marché intra-famille → création d'un sous-agent avec le modèle défini explicitement (voir §7).
Enregistrez l'attribution dans le plan. L'attribution a lieu UNE FOIS, au début de la construction, et est écrite dans la section ## Attribution du plan d'ancrage (voir rjv-feature-workflow) : orchestrateur, auteur, relecteur, niveaux de sous-agents, portes humaines — avec les modèles nommés explicitement. Chaque reprise lit l'attribution et joue son rôle ; la boucle de validation ne renégocie jamais qui approuve. La réattribution est une décision enregistrée avec un pourquoi.
Deux règles d'attribution strictes (basées sur des preuves, ne pas déroger) :
- Le relecteur doit être au moins aussi fort que l'auteur. La force du relecteur est la source de la qualité ; la force de l'auteur n'est que la vitesse de frappe. Un modèle faible ne relit rien — testé : invité à trouver un vrai bogue dans du code livré, un modèle local 35B a dit « aucun bogue ».
- Préférez le multi-fournisseur pour le grill. Différentes familles de modèles manquent différents modes de défaillance ; une révision intra-famille hérite des angles morts de l'auteur.
L'humain est aussi un relecteur. Lors d'une exécution réelle, l'utilisateur a détecté un trou (latence du courtier) que LES DEUX modèles de pointe avaient manqué après quatre tours de grill. Présentez les conceptions à l'humain aux limites de phase ; leur expérience du domaine dépasse les a priori du modèle — lorsque leurs preuves en direct contredisent votre conception, la conception est mise à jour immédiatement et le dit.
2. Griller le CAHIER DES CHARGES avant tout code
Le grill à plus fort effet de levier a lieu avant l'implémentation. Dans le projet source, le verdict du premier tour du relecteur sur la conception était « non réalisable en l'état » — 10 scénarios d'attaque classés, 8 valides. Les corriger avant le code a coûté la réécriture d'un document ; après le code, cela aurait coûté la construction.
- Envoyez la spécification/la conception au relecteur avec : « ATTAQUEZ cette conception. Listez les scénarios de défaillance classés. Verdict : APPROUVÉ / NON-APPROUVÉ avec blocages. »
- Itérez spécification → attaque → amendement jusqu'à APPROUVÉ. Enregistrez chaque tour dans le document d'ancrage (v1 → v2 → v2.1 …), en notant quelles objections ont été acceptées sur le fond et lesquelles ont été rejetées avec des raisons.
- Un relecteur qui ne dit jamais NON-APPROUVÉ ne relit pas. Si chaque tour approuve instantanément, aiguisez l'invite (voir §4) ou réattribuez.
3. La boucle de validation (par étape d'implémentation)
vérification de la spécification → implémenter → auto-revue + test rapide → GRILL DU RElectEUR → corriger → re-grill … → APPROUVÉ → commit → suivant
- D'abord la spécification. Rédigez les critères d'acceptation de l'étape dans le document d'ancrage AVANT de la coder. S'évaluer contre une spécification inventée en cours de code, c'est ainsi que les bogues sont bénis.
- Auto-revue + test rapide jetable avant de passer le relais — détectez les bogues stupides à moindre coût afin que les tours du relecteur portent sur les bogues subtils.
- Grillez jusqu'à un APPROUVÉ explicite. Un aller-retour n'est pas une révision.
- Mettez en attente, ne tamponnez jamais. Limitez le nombre de tours de grill par étape (~6). Toujours bloqué → écrivez les blocages ouverts dans le document d'ancrage et ARRÊTEZ cette étape. Une mise en attente délibérée « pourquoi » vaut mieux qu'une approbation falsifiée — non négociable quand l'argent ou la sécurité est en jeu.
- Plan vivant / retours en arrière. Lorsqu'un grill invalide une étape ANTÉRIEURE approuvée : rouvrez-la, corrigez, testez à nouveau, re-grillez, ENREGISTREZ le retour en arrière. Une étape erronée verrouillée est pire qu'une étape rouverte.
4. Piloter le relecteur — règles d'invite
- REVUE UNIQUEMENT. Première ligne : « REVUE UNIQUEMENT — ne modifiez pas les fichiers, n'implémentez pas. » Le relecteur lit, raisonne, vote.
- C'est vous qui exécutez les tests, pas le relecteur. Les bacs à sable du relecteur bloquent sur l'exécution. Exécutez la suite vous-même, collez les résultats dans l'invite (« suite déjà exécutée : N réussis — révisez en lisant le code »). Lire des fichiers est acceptable ; exécuter ne l'est pas.
- Nommez les modes de défaillance. Pointez vers les fichiers exacts, la section de la spécification et une liste de recherche numérotée. Pour le code financier : double exposition, survente, intention perdue/dupliquée lors d'un redémarrage, conditions de course, idempotence, frais/précision, le chemin risqué spécifique qui vient d'être écrit. Les invites vagues produisent des revues vagues.
- Limitez chaque grill ; annulez d'abord en cas de dépassement de délai. Exécutez-le en arrière-plan avec une limite de temps réel (~12–15 min). En cas de dépassement : ANNULEZ le travail d'ABORD, vérifiez que rien ne tourne, relancez à partir de zéro. Tuez les processus orphelins. Limitez les relances (~3) ; pas de verdict persistant = échec de l'outillage → mettez en attente, ne simulez pas.
5. Le document d'ancrage (la vraie mémoire de la construction)
Un document de travail compressé par construction — et un dépôt comporte de nombreuses constructions. Ne gardez pas un seul RESUME.md global : utilisez la disposition de la compétence rjv-feature-workflow (.plans/<nom>.md par élément de travail, lié depuis la feuille de route de la fonctionnalité), afin que plusieurs constructions validées puissent être en cours et que chacune soit hydratée par son nom. Les sections ci-dessous vivent À L'INTÉRIEUR de ce fichier de plan. La conversation est jetable ; le document d'ancrage ne l'est pas. « La spécification est le seul artefact qui mérite ses jetons » (cavekit).
Sections possédées — chaque phase de boucle n'écrit que dans la sienne :
| Section | Propriétaire | Contient |
|---|---|---|
| OBJECTIF | humain + orchestrateur | un paragraphe, le point, ne jamais oublier |
| CONTRAINTES / VOCABULAIRE | humain | mots convenus, mots morts, limites strictes |
| REGISTRE DES PREUVES | orchestrateur | résultats en direct comme contraintes de conception — idées réfutées marquées « ne pas ressusciter » |
| INVARIANTS | tours de grill | règles de fer qui ont émergé, chacune traçable jusqu'à un tour ou un cadavre |
| CONCEPTION vN | boucle spécification-grill | conception actuelle + la trace du grill (v1 → v2 → …, qui a objecté, ce qui a été accepté sur le fond) |
| TÂCHES / PLAN | orchestrateur | phases avec critères d'acceptation ; chaque idée a un FOYER ou est tuée |
| BOGUES / CADAVRES | implémentation | échecs étudiés au niveau le plus bas, taxonomisés |
| PIERRES TOMBALES | orchestrateur | questions résolues gardées visibles « pour que personne ne les rouvre » |
| OUVERT | tout le monde | éléments véritablement indécis, signalés UTILISATEUR lorsque l'humain doit décider |
Règle d'enregistrement — compressez par public :
- Tout ce que les agents lisent (ce doc, RESUME, invites de grill, mémoire) : registre d'homme préhistorique. Faits, fichier:ligne, impératifs. « enregistrer l'ordre AVANT l'envoi (sync fill drop → oversell) » — pas de prose. Écrit pour un lecteur sans contexte et 10 secondes. ~75 % moins cher à chaque relecture, et les relectures sont le coût récurrent.
- Tout ce que les humains lisent (réponses, documentation utilisateur) : prose normale, exemples concrets avec des chiffres. Les échecs de compréhension coûtent plus cher que les jetons de sortie.
- La séparation des deux publics est explicite : les notes d'agent passent à la documentation utilisateur uniquement lorsqu'elles sont concrètes et convenues.
**La règle du « pas plus tard ». Ne reportez jamais quoi que ce soit à « plus tard ». Chaque idée a un foyer dans une phase nommée (avec pourquoi là-bas) ou est tuée. Dans le projet source, « plus tard » cachait l'expérience la plus précieuse — elle est devenue le PREMIER élément de construction une fois révélée. Le seul report acceptable = une véritable dépendance structurelle, énoncée.
Maintenance de la compression. Le document d'ancrage et les fichiers mémoire sont relus à chaque reprise — ils sont un coût d'ENTRÉE récurrent, le type coûteux. Périodiquement (à la fin d'une phase, ou lorsque le document gonfle), réécrivez-les dans le registre : supprimez la prose, conservez les faits. Règles de compression : ne touchez jamais aux nombres, identifiants, références fichier:ligne, code, commandes ou texte d'erreur (octet exact) ; ne compressez jamais le sens du REGISTRE DES PREUVES — une nuance perdue rouvre une idée réfutée. Les sections de conception obsolètes se réduisent à des pierres tombales d'une ligne ; la trace du grill ne conserve que le tour + le verdict + ce qui a changé.
6. Rester en vie — l'exécution doit survivre aux interruptions
Deux modes de défaillance se PRODUIRONT lors d'une longue exécution : le relecteur bloque, et votre propre connexion se coupe en milieu de réponse. La défense est la même : ne conservez jamais l'état uniquement dans la conversation en direct.
- Pointeur de reprise + réconciliation à l'ouverture. La section Prochaines Étapes du document d'ancrage est réécrite à la FIN de chaque étape : étape en cours + statut, action exacte suivante, fichiers à lire impérativement, règles strictes. À chaque reprise — après compaction, après interruption, réveil programmé — la PREMIÈRE action est le rituel de réconciliation
rjv-feature-workflow: lisez le plan → VÉRIFIEZ chaque affirmation « fait » par rapport au code/à la base de données réels → notez la dérive → réécrivez les Prochaines Étapes → apposez le tampon Dernière réconciliation → puis agissez. Ne faites jamais confiance à une case à cocher obsolète ; une interruption peut avoir perdu la modification que la case à cocher prétend. - Commitez tôt et souvent. Chaque étape approuvée est commitée immédiatement. Une interruption perd alors au plus la modification en cours, pas le travail d'une nuit.
- Programmez vos propres réveils. Lorsque vous confiez le travail à un grill limité dans le temps, programmez un auto-réveil (~15 min) afin de REVENIR ACTIVEMENT — les surveillances passives « le travail me rappellera » peuvent mourir silencieusement.
- Étapes idempotentes. Vous pouvez rentrer en milieu d'étape après une interruption ; rendez les effets de bord sûrs à rejouer (clés de déduplication, upserts, vérifications déjà effectuées).
7. Économie de modèles — ne brûlez pas le modèle phare sur tout
Les longues exécutions coincent sur le budget/les limites de débit avant de coincer sur la difficulté. L'achèvement dépend de la frugalité :
- Par défaut, le moins cher. Modèle petit/rapide pour les sous-agents mécaniques (le TRANSFERT du relecteur est un appel bash — optez pour le moins cher ; la qualité du grill est celle du modèle du RElectEUR, pas du transfert). Niveau intermédiaire pour le code et l'analyse de routine.
- Modèles locaux pour les fonctions implémentables à partir d'une spécification — coût nul, et à partir d'un cahier des charges précis, ils atteignent ~90 % de qualité de production. Jamais comme relecteurs (règle stricte 1). Voir la compétence
rjv-ollama-delegate. - Réservez le modèle phare pour la conception, la synthèse, le jugement final et le grill lui-même.
- Définissez le modèle EXPLICITEMENT par sous-agent — n'héritez jamais par défaut du parent coûteux.
8. Honnêteté de la portée — en particulier pour les systèmes financiers
Indiquez clairement ce que « fait » signifie. « APPROUVÉ par le relecteur jusqu'à l'étape N » ≠ « validé par rapport au monde réel » si l'exécution n'a exercé qu'une voie simulée/sur papier. Gardez les portes dangereuses — trading en direct, déploiements de production, opérations destructrices — physiquement désactivées jusqu'à une phase de validation séparée et explicite avec sa propre porte (parité papier, bandes de ratio de remplissage, seuils de fermeture en cas de défaillance). Ne laissez jamais « approuvé » signifier « sûr à expédier ».
Annexe — lorsque le relecteur est OpenAI Codex CLI
Spécificités opérationnelles durement acquises pour piloter Codex comme grill :
- Annulez d'abord, ne vous rattachez jamais. En cas de dépassement du délai du grill, ne vous « rattachez pas pour préserver son travail » — le rattachement peut mourir instantanément et silencieusement, vous laissant sans surveillance tandis que le travail orphelin tourne pendant des heures. Toujours : annulez le travail → vérifiez qu'aucun ne tourne → relancez avec
--fresh. - pkill des orphelins. Les travaux annulés/bloqués laissent derrière eux des processus
codex app-server,codex resumeetapp-server-broker; faitespkill -9 -fsur eux lors du nettoyage afin qu'ils ne s'accumulent pas sur une longue exécution. - Son bac à sable ne peut pas exécuter vos tests (souvent pas de répertoire temporaire accessible en écriture ; il bloque « en vérification » indéfiniment) — c'est POURQUOI la règle du §4 « vous exécutez les tests » existe. Lire des fichiers (grep/sed/cat) dans son bac à sable est acceptable.
- Il peut écrire des fichiers mais pas exécuter git — commitez depuis la session de l'orchestrateur après qu'il a terminé.
- Les identifiants de session/thread de sa sortie sont reprenables (
--resume-last/ reprendre par id) — utiles pour les grills de suivi qui ont besoin du contexte du tour précédent, sous réserve de la règle d'annulation d'abord ci-dessus.
Invariant en une ligne : relecteur indépendant + état compressé sur disque + auto-réveils programmés = une exécution qui converge vers l'exactitude et survit à chaque blocage, interruption et compaction en cours de route.
Provenance : distillé à partir d'une construction réelle à enjeux élevés (robot de trading d'options, 2026-07 : 6+ tours de grill, de vrais NON-APPROUVÉs, un trou de conception détecté par un humain, pertes étudiées au niveau du tick) et d'un pic de délégation vérifié sur modèle local. Les idées de registre + de section de spécification sont créditées à la famille caveman/cavekit (github.com/juliusbrussee).