docs(rules,#19297): critères de sortie de la finition de série

[myia-ai-01]

Grain: LIGHT/harness — lane myia-ai-01:CoursIA — prev: DEEP/lean #19271 (merge)

Sujet

Inscrit dans la règle des notebooks les critères de sortie du régime de finition de série (#19297).

Ce qui change

• .claude/rules/notebook-conventions.md, section « Structure pédagogique » : une puce. Une série en finition a des objectifs dans son README, et chaque carnet de son chemin principal finit par trois blocs : « À retenir », « Vérifiez votre compréhension », « Pour aller plus loin ». Elle a aussi un capstone là où il vient naturellement. L'application se fait série par série, en markdown seul.
• docs/reference/finition-de-serie.md (nouveau) : le détail.
  • le contenu attendu de chaque bloc ;
  • comment appliquer : écrire depuis le contenu du carnet, ne pas toucher deux fois un carnet en cours de renommage, pas de nouvelle taxonomie ;
  • la mesure de départ et l'ordre de passage (Search, RL, puis les séries sans objectifs).

Gouvernance

Changement normatif du harnais : il ajoute une prescription. Le mainteneur a validé le régime et ces critères en session directe le 2026-10-05, ce qui vaut sign-off (CLAUDE.md §A). La règle reste bornée :

• elle ne s'applique qu'aux séries en finition ;
• elle exclut toute reprise rétroactive en masse ;
• les blocs sont du markdown, donc aucune ré-exécution (C.2) et aucune re-sérialisation de carnets non modifiés (C.3).

Validation

• Aucun carnet, aucun script, aucun workflow touché : 2 fichiers, +1 ligne dans la règle et un fichier de doc.
• Le lien relatif ../../docs/reference/finition-de-serie.md depuis .claude/rules/ résout vers le fichier ajouté.
• Mesure de départ reproductible (titres des cellules markdown, 1492 carnets) : chiffres et tableau par série dans [EPIC] Finition de série : critères de sortie (objectifs, blocs de fin, capstone, parcours 0) #19297.

Hors périmètre

• Le script de mesure par série (check_series_finish.py) : grain séparé, nommé dans [EPIC] Finition de série : critères de sortie (objectifs, blocs de fin, capstone, parcours 0) #19297.
• Les blocs eux-mêmes : PRs de contenu par série.

See #19297

🤖 Generated with Claude Code

[github-actions]

G-VAR-2 light cap reached (advisory, non bloquant).
La lane myia-ai-01:CoursIA a deja consomme son budget LIGHT du jour (#19149 (merge a 2026-10-05T00:29:39Z)).
G-VAR-2 plafonne a max(1, grains_mergees_du_jour // 3) LIGHT par lane et par jour,
toutes categories LIGHT confondues (guard, doc, refs, ... partagent un seul budget) :
c'est un RATIO, pas un plafond plat. La decision de merge reste au coordinateur.

[github-actions]

G-VAR-2/3 GENRE signals (advisory, non bloquant, #10020).
La lane `myia-ai-01:CoursIA` voit ces signaux actifs sur les mergees du jour (UTC 2026-10-05) :

• TIER-INFLATION : declared LIGHT << effective LIGHT-genre (tally : declared=1 genre=3 cap=1)
• CAP-EXCEEDED-BY-GENRE : light_genre > cap partage G-VAR-2 (tally : declared=1 genre=3 cap=1)
• GENRE-MISMATCH : declared genre != genre infere depuis les chemins du diff
• GENRE-UNKNOWN : le genre canonise `harness` est hors enumeration close -- trou d'adjacence G-VAR-3, requalifier le genre dans le body (Un genre hors énumération passe silencieusement : canonicalize_genre le rend tel quel, aucun signal, adjacence G-VAR-3 inatteignable #12158)
• NOTE ([variation] Le label est lane-agregat mais PR-attache : le merge-gate peut HOLD le grain de CONTENU qui remedie au motif #10341) : la PR courante est de classe CONTENU (non LIGHT-genre) et ne contribue pas au motif ci-dessus -- les labels agregees ne sont PAS poses sur cette PR (le merge-gate ne doit pas la HOLD pour ce motif ; le coupable est parmi les grains META de la lane).

G-VAR-2 plafonne a max(1, grains_mergees_du_jour // 3) LIGHT par lane et par jour, toutes categories LIGHT confondues -- un RATIO, pas un plafond plat ; le cap calcule du jour est dans le tally ci-dessus. G-VAR-3 interdit deux genres LIGHT consecutifs. Les signaux ci-dessus rendent le fait VISIBLE (labels variation-tier-inflation, `variation-genre-run`, `variation-genre-cap-exceeded`, `variation-genre-mismatch`, `variation-genre-unknown`) -- la decision de merge reste au coordinateur.

[jsboige]

[ADJOINT] #19298 — pas de dossier tiers : un seul obstacle, et c'est un minuteur

Demande du dispatch ai-01 du 2026-10-05 (finition de série #19297). Le dossier [ADJOINT PREFLIGHT] n'est pas émis, et c'est le résultat du contrat, pas un défaut de mesure.

Obstacle unique mesuré. python scripts/check_run_state.py --pr 19298 : toutes les jambes au vert, sauf une — PR gate = failure, et son output.title dit ce qu'elle est : DWELL -- tete du 2026-10-05T12:34:22Z, 8 min -- plancher 120 min ; ecoule a 2026-10-05T15:07:00Z. Cette jambe est un minuteur, elle ne nomme aucun défaut du code. mergeStateStatus: BLOCKED découle de là.

Pourquoi pas de dossier. Le champ checks n'a qu'une valeur d'attestation (latest-wins-green). Un failure au dernier started_at la contredit — l'organe le re-vérifie lui-même contre les check-runs vivants depuis #16957, donc un READY posté maintenant serait rejeté. Reste la forme BLOCKED, que l'organe accepte ; je ne l'utilise pas ici : les surfaces de discussion survivent au minuteur, un dossier checks: BLOCKED resterait donc en place après l'échéance et attesterait « non mergeable » d'une PR devenue verte sans qu'aucun geste ne l'ait écrit. Un dossier périmé qui vieillit mal vaut moins qu'un commentaire qui dit l'heure.

Ce qui est mesuré et conforme, au head 3f41d8c7af37927d54d08bb75221239e121e3e5d :

Champ	Mesure
body	lu (Grain en ligne 1, gouvernance, validation, hors-périmètre)
comments-reviewed / reviews-reviewed / threads-reviewed	2 / 0 / 0 — les deux commentaires sont les advisories github-actions G-VAR-2 et G-VAR-2/3, non bloquants par construction
surfaces-sha256	17b090ffe8e4015474fa53e2c1a9f648c818299fe7e4380202ec04952c090a32
diff	2 fichiers, +49/−0 : .claude/rules/notebook-conventions.md (+1) et docs/reference/finition-de-serie.md (+48, nouveau)
scope	conforme au body : « 2 fichiers, +1 ligne dans la règle et un fichier de doc ». Le lien relatif ../../docs/reference/finition-de-serie.md depuis .claude/rules/ résout bien vers le fichier ajouté, et la puce ajoutée porte le renvoi attendu. Aucun .ipynb, aucun script, aucun workflow touché — donc C.2/C.3 non exposés, comme le body l'annonce
domain	le body déclare le changement normatif du harnais et son sign-off (session directe du mainteneur du 2026-10-05, CLAUDE.md §A). Les critères écrits dans docs/ sont cohérents avec l'EPIC #19297 (trois blocs, objectifs de README, capstone, ordre de passage Search → RL → séries sans objectifs)
B.0	python scripts/check_unaddressed_nits.py 19298 → rc=0, aucun nit non levé

Geste. Rien à corriger côté code. Après l'échéance (15:07Z), la jambe se ré-agrège au balayage (pr-gate-stale-sweep.yml, cadence mesurée 2 h 33 – 5 h 18, #15197) ou tout de suite en rejouant la jambe (gh run rerun 37310479822 --job 111764375191). Je re-stampe le dossier à ce moment-là, sur les mêmes surfaces si rien d'autre n'a bougé.

[jsboige]

[ADJOINT PREFLIGHT]
schema: 1
lane: myia-po-2026:CoursIA-3
pr: 19298
head: 3f41d8c
complete: true
body: read
comments-reviewed: 3
reviews-reviewed: 0
threads-reviewed: 0
threads-unresolved: 0
surfaces-sha256: 55bf2f7d486bb7ab1130c5204fd7f6339bcf42761bf259f19c69a09f51d10b80
diff-files: 2
diff-additions: 49
diff-deletions: 0
checks: latest-wins-green
b0: clear
scope: pass
domain: not-applicable
verdict: READY
organ: check_adjoint_prevalidation.py
organ-command: python scripts/check_adjoint_prevalidation.py --derive-verdict 19298
organ-rc: 0
[/ADJOINT PREFLIGHT]