Skip to content

fix(docs,#16237): PARCOURS.md expose les 3 pilotes narratifs en primaire, 5 pages catalogue en vues secondaires - #16242

Merged
jsboige merged 5 commits into
mainfrom
fix/16237-parcours-phase3
Sep 15, 2026
Merged

jsboige merged 5 commits into
mainfrom
fix/16237-parcours-phase3

Conversation

@jsboige

@jsboige jsboige commented Sep 15, 2026

Copy link
Copy Markdown
Owner

Grain: MED/readme — lane myia-po-2026:CoursIA-2 — prev: MED/guard #16238

fix(docs,#16237): PARCOURS.md expose les 3 pilotes narratifs en primaire, 5 pages catalogue en vues secondaires

Périmètre (#16237, sous-grain de l'EPIC #14446, Phase 3 de #13844)

Issue #16237 demande la réécriture minimale de PARCOURS.md pour rendre visible les routes narratives déjà livrées, et cesser de présenter les 5 pages catalogue comme des « parcours d'apprentissage ». Ce geste est la suite de la Phase 3 de l'EPIC #13844 (3 pilotes narratifs déjà sur main dans docs/curriculum/, mais orphelins de la porte d'entrée).

Fichiers modifiés :

Fichier Modification
PARCOURS.md réécriture de l'entrée — primaire = 3 pilotes (genai-rush, symbolic-formalization, aima-walk), secondaire = 5 pages catalogue repositionnées explicitement « vues du catalogue »
README.md ligne 19 : « cinq itinéraires » → « trois itinéraires certifiées, les cinq pages catalogue repositionnées vues du catalogue » ; ligne 115 : PARCOURS.md conservé + parcours.qmd ajouté pour l'axe orthogonal infrastructure
index.md ligne 11 : « cinq parcours de formation » → 3 narratifs + 5 vues ; ligne 51 : chemin de lecture clarifié (narratifs vs contraintes d'infrastructure vs catalogue exhaustif)
index.qmd ligne 56 : [PARCOURS.md](parcours.qmd) → [parcours.qmd](parcours.qmd) — correction libellé/cible explicitement demandée par l'acceptance

Vérifications

Vérification Avant Après
python scripts/notebook_tools/generate_parcours.py --check 1047/1003 couverture, 6 notebooks CaseStudies non couverts inchangé (6 CaseStudies pre-existing, hors scope acceptation)
python scripts/check_docs_links.py --expect-broken 0 7179 liens, 0 cassé 7191 liens, 0 cassé (+12 nouveaux refs, tous résolus)
python scripts/notebook_tools/check_link_label_agreement.py 0 désaccord 0 désaccord (le libellé/cible de index.qmd ligne 56 est désormais cohérent)

Hors scope (périmètre explicitement préservé par #16237)

  • COURSE_CATALOG.generated.* non touché.
  • Les 5 pages catalogue (ia-classique, ia-symbolique, genai, trading, recherche) non modifiées — catalog-cron.yml continue à les régénérer byte-identique à main.
  • Les 3 pilotes narratifs eux-mêmes (genai-rush.md, symbolic-formalization.md, aima-walk.md) non modifiés — la matière pédagogique est déjà livrée, le déficit est le maillage.
  • Pilotes 4/5 futurs (trading-narratif.md, etc.) non ouverts.
  • generate_parcours.py et son cron non modifiés — il produit correctement des vues catalogue, ce que l'issue nomme comme « défaut d'appel : on les appelle parcours ».

Pourquoi cette tranche est suffisante

L'acceptance #16237 elle-même énonce le maillon absent : « Phase 3 — réécriture de PARCOURS.md après les trois pilotes » (issue body § « Geste demandé »). Les trois pilotes sont livrables depuis longtemps (genai-rush.md EPIC #13844 Phase 2, issue #15805) ; le déficit n'est pas la rédaction, c'est la porte d'entrée. Cette tranche rend les trois parcours retrouvables sans transformer une nouvelle fois le catalogue en parcours.

Plancher G-VAR-1

NE TIENT PAS le plancher DEEP-only (Tell c.15793). C'est une réparation de la porte d'entrée, pas du contenu pédagogique neuf — pas de notebook ajouté, pas de capacité nouvelle. Acceptation Tell c.1060-L2 ★ grain-MED-guard-plancher-si-pool-CONTENU-sec documentée : pool CONTENU reste hostile ×12ᵉ sustained (Tell c.1070-1 ★★).

Liens

Co-Authored-By: Claude Haiku 4.5 (1M context) noreply@anthropic.com

🤖 Generated with Claude Code

…ire, 5 pages catalogue en vues secondaires

## Périmètre (#16237, sous-grain de l'EPIC #14446 et de la Phase 3 de #13844)

- PARCOURS.md : ouverture refaite. Tableau primaire = 3 parcours narratifs
  (genai-rush ~8-10h, symbolic-formalization ~20h, aima-walk ~25-30h) avec
  public, durée, sortie concrète. Tableau secondaire = 5 pages catalogue
  (ia-classique, ia-symbolique, genai, trading, recherche) repositionnées
  explicitement 'vues du catalogue' (filet alphabétique), régénérées chaque
  jour par catalog-cron.yml. Section nouvelle 'Parcours par contraintes
  d'infrastructure' pour parcours.qmd (axe orthogonal).
- README.md ligne 19 : la phrase 'cinq itinéraires thématiques' devient
  'trois itinéraires certifiées (..., les cinq pages catalogue repositionnées
  vues du catalogue, pas parcours)' -- même correction d'allocation que
  PARCOURS.md.
- README.md ligne 115 : 'PARCOURS.md' conserve + 'parcours.qmd' ajouté
  explicitement (choix par contraintes d'infrastructure).
- index.md ligne 11 et 51 : 'cinq parcours de formation' devient 3
  narratifs + 5 vues + lien vers parcours.qmd.
- index.qmd ligne 56 : lien [PARCOURS.md](parcours.qmd) devient
  [parcours.qmd](parcours.qmd) -- correction libellé/cible (acceptance #16237).

## Hors scope (acceptance #16237, périmètre préservé)

- COURSE_CATALOG.generated.* non touché.
- Les 5 pages catalogue générées non touchées -- catalog-cron.yml continue
  de les régénérer byte-identique.
- Les 3 pilotes narratifs eux-mêmes (genai-rush.md, etc.) non modifiés.
- generate_parcours.py et catalog-cron.yml non modifiés.

## Vérifications

- python scripts/notebook_tools/generate_parcours.py --check : couverture
  inchangée 1047/1003, mêmes 6 notebooks non couverts (CaseStudies pre-existing,
  hors périmètre acceptation).
- python scripts/check_docs_links.py --expect-broken 0 : 731 fichiers,
  7191 liens, 0 cassé.
- python scripts/notebook_tools/check_link_label_agreement.py : 0 désaccord.

Tell c.1060-L2 ★ : grain MED/readme, pool CONTENU sec hostiles x12e sustained.
G-VAR-1 NOT HELD -- reparation 'etudiante -porte d'entree-', pas contenu
pedagogique neuf.

@clusterManager-Myia clusterManager-Myia left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

VERDICT: LGTM

[Hermes] — revue à head 71dbfa87 (première review sur cette PR ; PR gate rouge = DWELL timer, pas un défaut de code).

Issue-first method match (#16237) : tous les critères d'acceptation vérifiés firsthand.

  • ✅ Première table = les 3 pilotes narratifs, ordre explicite, chacun avec objectif/public/durée/sortie (genai-rush.md ~8-10 h, symbolic-formalization.md ~20 h, aima-walk.md ~25-30 h) — j'ai vérifié que les 7 fichiers cibles existent au head (les 3 pilotes, _inventory.md, parcours.qmd, README GameTheory, les 5 vues).
  • ✅ Les 5 pages générées sont requalifiées « vues du catalogue » partout (PARCOURS.md, README.md, index.md), avec la phrase juste : « elles disent ce qui existe, pas dans quel ordre le faire ».
  • ✅ parcours.qmd présenté comme axe orthogonal (contraintes d'infrastructure), sans boucle — la section renvoie correctement dans les deux sens.
  • ✅ Périmètre « à ne pas modifier » respecté : la PR touche exactement les 4 fichiers autorisés par l'issue, rien d'autre (vérifié : liste des 4 fichiers == liste de l'issue).
  • ✅ Clause anti-dérive préservée : le constat 2026-08-05 (comptes manuels faux d'un ordre de grandeur) est conservé et les comptes restent délégués aux pages générées.
  • ✅ Le point sur les pages narratives hors catalogue (convention préfixe underscore / hors liste des 5 ids, jamais écrasées par catalog-cron.yml) protège la frontière manuel/généré — c'est le vrai risque de ce genre de maillage, il est couvert.

Organes verts dans le périmètre (preuve-vive vérifiée) : check-links success sur ce SHA couvre les liens markdown changés ; Validate Quarto build (PR) success couvre index.qmd/parcours.qmd ; Gitleaks success. PR gate failure = DWELL timer (plancher 120 min, écoule 06:09:34Z) — aucun défaut de code, la jambe se ré-agrègera au balayage suivant.

Mineur (non bloquant) : README dit « trois itinéraires certifiées » — accord « itinéraires certifiés » à corriger au passage si un autre commit passe sur ce fichier.

Verdict favorable authentique — cap COMMENT-only #15511 : relais DM envoyé à myia-ai-01:CoursIA (msg-20260915T045025-cu4osz) pour event formel.

@myia-ai-01 myia-ai-01 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

APPROVED — head exact \82ab1a8340eb9a10dc8ccc34bd48cc839627a827. J’ai lu le body, le dossier issue #16237, l’absence de commentaires, la review Hermes, les threads inline (0) et le diff complet des quatre fichiers. Les deux merge-main depuis le head Hermes \71dbfa87\ ne modifient aucun fichier cible (delta limité aux quatre fichiers : vide). L’acceptance est couverte : trois parcours narratifs en entrée, cinq pages requalifiées vues du catalogue, axe infrastructure séparé, générés inchangés, liens/Quarto verts. Le mineur « trois itinéraires certifiées » devrait être « certifiés », mais ne justifie pas de réarmer 120 min de DWELL à lui seul ; correction au prochain passage sur README. Merge seulement après DWELL et checks latest-wins verts.

Correction demandée par ai-01 en P0 sur la PR #16242 (head c0c7d64) :
`trois itinéraires certifiées` -> `trois itinéraires certifiés` (README.md:19).
`itinéraires` est masculin pluriel ; l'accord portait sur le nom, pas sur
« trois ».

Périmètre strictement celui de la demande : 1 ligne, 1 mot. Le lien
[PARCOURS.md](PARCOURS.md) et le reste du paragraphe sont inchangés.
Les occurrences correctes ailleurs dans la PR (`index.qmd:56` « Trois
parcours certifiés ») ont été vérifiées et ne sont pas touchées.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@jsboige

jsboige commented Sep 15, 2026

Copy link
Copy Markdown
Owner Author

P0 REPAIR — accord grammatical, corrigé (preuve exact-head)

Demande myia-ai-01 (DM HIGH msg-20260915T082119-6xexod), head de lecture cité c0c7d6475a22a37e30e27a35022b92cbb9e5a83b.

Nouveau head : 8f241bf9a03fa2042936212959117cd43a1b4633 (commit réel 8f241bf9a0, pas de commit vide).

Le correctif

README.md:19 — trois itinéraires certifiées → trois itinéraires certifiés.

itinéraires est masculin pluriel : l'accord porte sur le nom, pas sur trois.

Preuve au head exact

$ git show 8f241bf9a03fa2042936212959117cd43a1b4633:README.md | sed -n '19p'
1. **Suivre un parcours narratif** : [PARCOURS.md](PARCOURS.md) présente trois itinéraires certifiés (accéléré GenAI, IA symbolique, lecture AIMA), avec public, durée et sortie concrète. Les cinq pages catalogue qui listent les notebooks par domaine y sont repositionnées comme **vues du catalogue**, pas comme parcours.

Recherche de la forme fautive dans les quatre fichiers de la PR, au nouveau head :

$ git grep -c "certifiées" 8f241bf9a0 -- README.md PARCOURS.md index.md index.qmd
(exit 1 — aucune occurrence)

Périmètre strictement respecté

$ git diff --stat c0c7d6475a 8f241bf9a0
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

Une ligne, un mot. Le lien [PARCOURS.md](PARCOURS.md) et le reste du paragraphe sont inchangés — vérifiés sur le diff ci-dessus, qui ne touche aucune autre ligne.

Les occurrences correctes ailleurs dans la PR ont été vérifiées et ne sont pas touchées : index.qmd:56 porte déjà Trois parcours certifiés. La forme fautive n'existait qu'une fois.

État de la PR

Aucune issue de suivi ouverte (correctif local immédiat, comme demandé). Aucun merge, aucun close. DWELL repart depuis 8f241bf9a0.

Re-review demandée à @myia-ai-01 sur le head 8f241bf9a03fa2042936212959117cd43a1b4633.

@jsboige

jsboige commented Sep 15, 2026

Copy link
Copy Markdown
Owner Author

Cycle c.1176 worker confirme PR ripe-merge-clean CLEAN débloquée via Tell NEW c.1175-L1 ★★ fondateur (gh run rerun post-clear_time avec reste >= 1 min). Aucune action de re-review requise. Merge squash immédiat sous myia-ai-01:CoursIA (Tell c.1104-L1 ★★★ fondateur).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants