Quand charger / Quand ignorer
- Charger : tâche à champ ouvert, pas de critère prédéfini ; les résultats doivent être vérifiés par autre chose que le producteur ; besoin d'un équipage de sous-agents avec outils variés.
- Ignorer : spec serrée avec acceptation fixe (exécution simple) ; tâche triviale ; situation de crise / contrainte de temps – dans ce cas, ajouter des objectifs plus durs n'ajoute que du risque, et "l'engagement s'effondre sous la pression du temps" est une hypothèse (à tester par l'agent), pas un fait établi.
- Ce fichier ne déclenche que les schémas d'activation, le chemin rapide, et le contexte permanent de la machine d'état ; tout le reste est chargé par nœud de la machine d'état (ADR-1 / ADR-12).
Chemin rapide (version trois minutes)
- Première action = compilateur d'objectifs : traduire la requête en un trio (détails dans
chapters/01-goal-compiler.md) :- Invariant : résultat plutôt que tâche (ex. "corriger les plantages" → "garder les applications sans plantage") ;
- Vérificateur : format commande falsifiable (commande + sortie attendue), pas de texte descriptif, pas de vérificateur inventé ; si un élément manque, indiquer ce qui manque et où le trouver ;
- Manifeste d'environnement : accès télémétrique / version de référence / environnement de reproduction.
- Tout produit dégradé (y compris les objectifs d'apprentissage) doit repasser par ce compilateur (ADR-2 / ADR-7).
- Niveau minimum du juge = sous-agent en contexte vierge, lecture à l'aveugle : il ne voit que la production, pas le discours de l'exécutant. Citation clé :
"I implore you to insist on outside validation. Ideally that's a tool the model can run to get feedback immediately." (Je vous implore d'insister sur la validation externe. Idéalement, c'est un outil que le modèle peut exécuter pour obtenir un retour immédiat. — Felix Rieseberg, How to be more ambitious ; entrée vérifiée dans
research/ledger-a.md) - Deux points de contrôle humains obligatoires : confirmation de l'objectif, acceptation finale (voir
references/decision-checkpoints.md). Clause de procuration : quand l'exécutant est un sous-agent / pas d'humain dans la boucle, le point de contrôle peut être signé par le niveau supérieur de la chaîne de délégation (le mandant), avec mention du mandataire dans l'enregistrement de l'affirmation ; si personne ne peut signer, marquer UNVERIFIED + trois lignes (QUERY / WHERE / RESULT), ne pas considérer comme validé en silence. - Trois drapeaux uniquement (O-1) :
--quick: chemin dégradé (pas de processus complet, mais le champ vérificateur reste obligatoire) ;--no-crew: sauter le nœud d'équipage ;--judge=ctx-agent|tests|domain|human: spécifier le niveau de juge. Règles de combinaison : les trois drapeaux peuvent être utilisés librement ensemble.--quick×--judge=:--quickréduit seulement les nœuds du processus, pas le niveau de juge spécifié — le niveau spécifié s'exécute normalement sur les nœuds restants, sinon l'affirmation est marquée UNVERIFIED + trois lignes ; dans toute combinaison, le champ vérificateur (format CMD) reste obligatoire.--no-crewpour une tâche non-range = sans effet (no-op), pas une erreur.
La machine d'état
Processus : Compilation → Revue d'hypothèses → Exécution → Jugement → Échec ? → Protocole d'échec → Jugement final → Équipage (uniquement pour les tâches de type range). En cas de défaillance d'un nœud, consulter d'abord chapters/06-failure-modes.md.
| Nœud | Règles (ancres) | Chargement par nœud |
|---|---|---|
| Compilation | Trio ; verrouiller d'abord l'objectif difficile, ne passer à un objectif d'apprentissage que si "nouveau domaine et aucune stratégie éprouvée" est vraie (ADR-7) | chapters/01-goal-compiler.md ; references/goal-setting-rules.md, references/prompt-compiler.md |
| Revue d'hypothèses | ≤3 hypothèses, chacune avec la falsification la moins chère ; preuves en récit complet | chapters/01-goal-compiler.md ; references/assumption-audit.md |
| Ton d'exécution | ADR-10 en couches : échafaudage pour les couches processus et acceptation, blanc pour la couche récit d'exécution ; nombre maximum de niveaux paramétrable (défaut 5, valeur empirique) | chapters/03-execution-voice.md ; references/inner-game-voice.md |
| Support par cas | Chercher 1–2 exemples par genre ; l'effet de précédent est un carburant, pas une méthode ; pas d'entrée sans champ vérificateur | chapters/05-evidence-cases.md ; references/exemplars.md, references/story-calibration.md |
| Jugement | Échelle de quatre niveaux ; tableau de correspondance type de tâche → niveau minimum ; critères de passage du juge séparés des conditions d'achèvement de l'exécutant dans un paragraphe distinct (O-2) ; fixture d'abord (ADR-11) | chapters/02-judge-ladder.md ; references/claim-format.md, references/judge-tools.md, references/worked-example.md |
| Échec ? Protocole | Attribution + réentraînement + micro-succès d'une sous-étape, les deux sont obligatoires ; taille de la sous-étape paramétrable (défaut équivalent 15 minutes, valeur empirique ; ADR-8) | chapters/03-execution-voice.md ; references/self-efficacy-sources.md |
| Jugement final | Logique de consommation : chaque affirmation est fermée (PASS/FAIL) ou explicitement UNVERIFIED + trois lignes sans enregistrement trouvé ; pas de seuil quantitatif (ADR-5) | scripts/check_claims.py ; references/claim-format.md |
| Point de contrôle humain | Deux obligatoires : ① confirmation de l'objectif (après compilation, avant exécution) ② acceptation finale (après jugement final) ; sous-agents selon la clause de procuration (chemin rapide, point 4) | references/decision-checkpoints.md |
| Équipage | Uniquement pour les tâches range : modèle de définition de sous-agent avec trois champs obligatoires (outils / données / critères d'acceptation) + budget, retry, couche de partage d'artefacts ; quatre étapes anti-roleplay — "don't write like a short seller, do what a short seller does" (N'écris pas comme un vendeur à découvert, fais ce que fait un vendeur à découvert. — Rieseberg ; entrée vérifiée dans research/ledger-a.md) | chapters/04-range-crew.md ; references/subagent-templates.md |
| Discipline des citations | Toute SOURCE-URL doit ramener à la source canonique ; toute citation doit comporter le texte original + traduction + source complète | references/sources.md |
Auto-vérification
- Q Chaque objectif est-il compilé en un trio <invariant + vérificateur au format CMD + manifeste d'environnement>, le vérificateur étant une commande falsifiable et non un texte descriptif ?
- Q Chaque critère de passage du juge est-il écrit dans un paragraphe indépendant, ne fait-il pas référence à l'affirmation d'achèvement de l'exécutant, et le tableau de correspondance a-t-il assigné un niveau minimum ?
- Q Chaque affirmation a-t-elle un enregistrement à cinq colonnes, un VERDICT parmi les trois valeurs, et aucune entrée non fermée au moment du jugement final ?
- Q Après un échec, a-t-on effectué à la fois une attribution + réentraînement et une sous-étape de micro-succès qui sert l'objectif original et est vérifiable (les deux sont obligatoires) ?
- Q Chaque modèle de définition de sous-agent a-t-il les trois champs obligatoires (outils, sources de données, critères d'acceptation), ainsi qu'un champ budget et un champ d'état de partage d'artefacts ?
- Q Chaque cas de référence a-t-il un trio, une validité, et un champ de verdict à trois valeurs, avec une note de calibration pour les cas légendaires ?