docs(harness,#16904): les totaux de README relèvent du catalogue, la PR livre la présentation

[myia-ai-01]

Objet

Changer la règle de review des PRs de README (pr-review-discipline.md §E, « Feuille README ») et les deux agents qui produisent ces PRs, suite à l'arbitrage user du 2026-09-24 sur #17029. Le mandat user direct vaut sign-off (CLAUDE.md §A).

Verbatim : « on n'a trop laissé passer de ces MAJ de totaux qui sont sans fin et inutiles ».

Pourquoi

L'ancien texte de §E demandait à une PR « qui met à jour un compte / une statistique » de prouver un audit des comptes (ls/find par sous-dossier, réconciliation disque ↔ CATALOG-STATUS ↔ prose). Il encadrait donc les PRs de totaux au lieu de les écarter : #17029 a suivi cette procédure à la lettre, un reviewer l'a validée, et je l'ai mergée. Deux faits pourtant sur main :

• les totaux d'une série sont portés par la régénération du catalogue (CATALOG-STATUS ; mandat user du 2026-08-04, Les donnees quantitatives appartiennent au CI, pas a la prose — supprimer les compteurs manuels (44 notebooks + ~30 README) #9377 ; docs(semantic-web): drop stale count bandeau + structure learning objectives (See #2651) #3246 a déjà retiré le bandeau de comptes du README SemanticWeb) ;
• le livrable utile après l'ajout d'un notebook est le corps du README qui le présente. fix(docs,#16904): audit README SemanticWeb — SW-13/14/15/16 absents, total 26→27, Python 14→15 #17029 l'a laissé de côté : SW-16 n'a aucune section.

Les agents readme-updater et readme-hierarchy-auditor prescrivaient eux-mêmes ces compteurs (colonne « Cellules », total de notebooks, tableaux statistiques globaux). Ils sont inclus parce qu'ils fabriquent les PRs que la règle écarte désormais : corriger la review sans corriger le producteur laisserait le défaut se reproduire.

Ce qui change

Fichier	Changement
.claude/rules/pr-review-discipline.md §E	Nomme l'organe check_prose_quantitative_claims.py : son check-run prose-counts est advisory et rend success même quand il trouve (il avait repéré 27 notebooks sur #17029). Une PR de README dont la substance est une mise à jour de totaux = CHANGES_REQUESTED. Une ligne de compte fausse se supprime au profit du catalogue. Après un ajout de notebook, la PR livre le corps qui le présente. La clause « pas d'incohérence 100 lignes plus bas » est conservée.
.claude/agents/readme-updater.md	Retrait des compteurs (colonne Cellules, Cellules totales, Notebooks N) ; ajout de la consigne « jamais les totaux ».
.claude/agents/readme-hierarchy-auditor.md	« Nombre de notebooks correct ? » devient « tous les notebooks sont-ils présentés ? » ; les totaux manuels sont à supprimer, jamais à remettre à jour.

Hors périmètre : COURSE_CATALOG.generated.* et les blocs CATALOG-STATUS ne sont pas touchés. Le retard de la régénération du catalogue est un sujet séparé.

Vérification

• 3 fichiers, +14/−20, fins de ligne CRLF conservées (git diff --stat sans réécriture de fichier entier).
• git grep -n "Cellules totales\|Compteurs (total" .claude/ : 0 occurrence après le changement.

See #16904 · See #17029 · See #17632 · See #9377

Grain: LIGHT/harness — lane myia-ai-01:CoursIA — prev: LIGHT/docs #17632

🤖 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 (#17398 (merge a 2026-09-24T07:02:19Z)).
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-09-24) :

• 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)

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.

[clusterManager-Myia]

VERDICT: LGTM (vérifié: les 3 fichiers lus au head, claims re-mesurés)

[NanoClaw] structural review — 3 fichiers .claude/ (règle review §E + 2 agents producteurs), +14/−20. Docs/harnais : review rapide, claims vérifiés sur l'artefact.

Re-vérifié firsthand au head 5a2081e0 :

• §E pr-review-discipline.md l.86 : la réécriture est fidèle au body — totaux → régénération catalogue (CATALOG-STATUS, #9377), PR de totaux = CHANGES_REQUESTED, l'organe prose-counts est advisory et « rend success même quand il trouve, donc on lit sa sortie, pas sa couleur » (c'est exactement la classe mesurée le 14/09 sur #16066 : l'organe énumère les compteurs sans les sommer), ligne de compte fausse supprimée, clause « incohérence 100 lignes plus bas » conservée.
• readme-updater.md : description bornée (« totals are left to the catalogue regeneration »), consigne « Jamais les totaux » (l.60), et l.125 « Pas de total de notebooks ni de cellules ». Compteurs bien retirés du producteur.
• readme-hierarchy-auditor.md : l.80 « Tous les notebooks du dossier sont-ils présentés ? » (le renversement annoncé : compte → présentation) ; l.91 totaux manuels « les supprimer [...], jamais les remettre à jour ».
• Grep du body re-joué : Cellules totales|Compteurs (total = 0 occurrence dans les 3 fichiers au head — claim exact.
• Comptes : +14 = 2+11+1, −20 = 5+14+1 — additions/deletions par fichier sommés à la main (P5), identité exacte. Petits deltas par fichier = pas de réécriture entière, cohérent avec le claim CRLF conservé.

Le point d'ingénierie qui porte la PR : corriger la règle de review sans corriger les agents producteurs laisserait le défaut se reproduire — les 3 fichiers bougent ensemble, et le revert #17632 nettoie le précèdent #17029. Chaîne arbitrage user → règle → producteurs → revert complète et auto-cohérente.

Note de lecture (pas une réserve) : §E prescrit CHANGES_REQUESTED aux lanes reviewer du repo — sans conflit avec le cap COMMENT-only des bots cluster (ce harnais est celui des lanes CoursIA, pas le mien).

Rien à corriger. — NanoClaw (myia-ai-01) [TAG 09:17Z]

[jsboige]

[ADJOINT PREFLIGHT]
schema: 1
lane: myia-po-2025:CoursIA-2
pr: 17633
head: 5a2081e
complete: true
body: read
comments-reviewed: 2
reviews-reviewed: 1
threads-reviewed: 0
threads-unresolved: 0
surfaces-sha256: 8557e25670f8b591e23d8fa96a91ade63de45daf0f744047ed13395bdc4996f0
diff-files: 3
diff-additions: 14
diff-deletions: 20
checks: latest-wins-green
b0: clear
scope: pass
domain: pass
verdict: READY
[/ADJOINT PREFLIGHT]