Repository navigation
docs(cadrage): répertoire et index des documents épistémiques de cadrage — agréger par communauté, pas par texte #17525
Description
Activity
[ai-01] Cadrage validé par le user le 23/09 (« OK pour le cadrage »). Les trois choix sont confirmés : (a) le répertoire
docs/cadrage/; (b) une agrégation par communauté interlocutrice, un texte n'obtenant un document propre que s'il change une pratique ou un gate ; (c) Singapore devientdocs/cadrage/singapore-consensus-self-audit.md. La migration continue dans l'ordre annoncé : Singapore d'abord (#16757), puis Leiden et Grothendieck après #17495 et #17467, puis Magnifica à la reprise du user.- added a commit that references this issue
on Sep 26, 2026 [CLOSURE PREFLIGHT]
schema: 1
lane: myia-po-2023:CoursIA
issue: 17525
verdict: KEEP
acceptance:- Tranche 1 — le répertoire et son index — livrée -> PR docs(cadrage,#17525): répertoire docs/cadrage/ + index agrégateur (tranche 1) #17965 MERGÉE (2026-09-26T20:16:54Z) ;
docs/cadrage/README.mdetdocs/cadrage/singapore-consensus-self-audit.mdprésents sur main, re-mesurés ce jour (git ls-tree -r origin/main -- docs/cadrage/) - Tranche 2 — migration de Leiden et Grothendieck — non exécutée -> les deux documents sont toujours au premier niveau de
docs/sur main ce jour (docs/leiden-declaration-position.md,docs/grothendieckian-lens.md) ; sa précondition est désormais levée (PR docs(#16756): Boussole apprendre→extraire→prouver dans la Déclaration Leiden #17495 MERGÉE, ticket 17467 CLOSED), donc la tranche est actionnable - Tranche 3 — migration de Magnifica — non exécutée ->
docs/magnifica-humanitas-dialogue.mdtoujours au premier niveau ce jour ; sa précondition reste la reprise du texte par le user (arbitrage du 22/09), donc hors de portée d'une lane - Livrable 3 — le renvoi unique — non exécuté ->
docs/README.mdliste encore les trois documents un par un (lignes 13, 14, 15, 195 et 196 mesurées ce jour) et ne renvoie pas versdocs/cadrage/README.md - Le grain est porté par une autre lane, sans PR ouverte -> [CLAIMED] lane myia-po-2026:CoursIA-2 du 2026-09-26T14:37:12Z ; aucune PR ouverte ne cite l'issue ce jour, et l'issue reste le tracker de ses tranches 2 et 3
residue: followup docs(cadrage): répertoire et index des documents épistémiques de cadrage — agréger par communauté, pas par texte #17525
open-prs: 0
comments-reviewed: 2
[/CLOSURE PREFLIGHT]
- Tranche 1 — le répertoire et son index — livrée -> PR docs(cadrage,#17525): répertoire docs/cadrage/ + index agrégateur (tranche 1) #17965 MERGÉE (2026-09-26T20:16:54Z) ;
[CLAIMED] lane myia-po-2024:CoursIA -- paths: docs/cadrage/*, docs/leiden-declaration-position.md, docs/grothendieckian-lens.md, docs/README.md -- Tranche 2 de la migration (cf README docs/cadrage) : les deux preconditions sont satisfaites (#17495 MERGED 24/09, #17467 CLOSED 27/09 via #17653) -- migration des deux documents + retablissement des liens entrants. Tranche 3 (Magnifica) reste gatee sur la reprise user, non embarquee.
[DELIVERED] lane myia-po-2024:CoursIA — tranche 2 livree par PR #19022 (
9a7b5815670) : migration deleiden-declaration-position.mdetgrothendieckian-lens.mddansdocs/cadrage/+ retablissement des 55 references entrantes sur 30 fichiers (docs/ict, index docs + cadrage, READMEs de series, _quarto.yml, ICT framing/manifest, archive, 1 cellule markdown de notebook, 1 cellule du CSV de traduction — parite 35/35 verte).Preconditions etaint satisfaites depuis le 27/09 (#17495 MERGED, #17467 CLOSEE via #17653) — la tranche etait due, le plan par tranches du README
docs/cadrage/la marque desormais faite.Reste la tranche 3 (magnifica-humanitas-dialogue.md), gatee sur la reprise user du texte (arbitrage du 22/09) — non embarquee par design.
- added a commit that references this issue
on Oct 4, 2026
Mandat
Arbitrage user du 23/09, à la lecture de #17495 et #16757 : consacrer un répertoire aux documents épistémiques de cadrage, et se poser plus finement la question des agrégats possibles. D'autres déclarations et chartes importantes existent, et d'autres suivront.
La famille aujourd'hui (mesure
main)Trois documents au premier niveau de
docs/, un quatrième égaré dansdocs/suivis/:grothendieckian-lens.mdmagnifica-humanitas-dialogue.mdleiden-declaration-position.mdsuivis/singapore-consensus-audit.mdProposition — agréger par communauté, pas par texte
Si chaque nouvelle déclaration a son document, la famille devient une étagère de grands noms. C'est le travers déjà écarté lors de la requalification de #16757.
Règle proposée. Un document par communauté interlocutrice. Un nouveau texte entre comme section du document de sa communauté. Il gagne un document propre seulement s'il change une pratique ou un gate du dépôt que le document existant ne peut pas porter. SAIR est entré ainsi dans Leiden (#17467).
leiden-declaration-position.mdmagnifica-humanitas-dialogue.mdsingapore-consensus-self-audit.mdaima-armature.md(à créer, Epic #17528, arc E)Un auteur n'est pas une communauté. Ses textes de position vont au document de la communauté concernée. Ses résultats techniques vont dans les séries, par un organe que la série exécute, pas par une citation. Un même auteur peut donc apparaître à trois endroits, et c'est l'index qui rend ces liens visibles.
La relation est encodée dans le nom : -lens, -dialogue, -position, -self-audit, -armature. Une relation nouvelle se nomme avant d'écrire.
Livrable
docs/cadrage/et sonREADME.md, qui est l'index et donc l'agrégat : une ligne par texte externe, avec sa date, l'institution émettrice, la communauté, la relation, le document ou la section qui le porte, et son statut (traité, section, veille). La veille y figure explicitement : un texte connu et non traité est une ligne, pas un oubli.python scripts/check_docs_links.py --checkà 0 nouveau lien cassé) :docs/cadrage/(Auto-auditer notre flotte selon les 10 principes du Singapore Consensus #16757) et le répertoire naît avec son index ;leiden-declaration-position.mdetgrothendieckian-lens.md, après le merge de docs(#16756): Boussole apprendre→extraire→prouver dans la Déclaration Leiden #17495 et docs(ethics): compléter la position Leiden par l'accord avec l'initiative SAIR Open Models #17467, qui touchent le fichier Leiden ;magnifica-humanitas-dialogue.md, seulement quand le user a terminé sa reprise du texte (arbitrage du 22/09).docs/README.mdet l'index racine pointent versdocs/cadrage/README.mdplutôt que vers chaque document.À trancher par le user (restitué au registre, défaut appliqué sinon)
docs/cadrage/(défaut, français, suit le vocabulaire « documents épistémiques de cadrage »).See #17528 · See #16757 · See #17467 · See #13112 · See #11359