Skip to content

Docs(harness): CLAUDE.md §Règles modulaires -- dire que le tableau par domaine est une vue datée (la commande fait foi) #23470

Open

Description

@jsboige

Signalé par la relecture de #23385 (point portant sur CLAUDE.md), et hors périmètre de cette PR : #23385 ne touche que le document de référence, pas le fichier de règles.

Constat

#23385 retire d'un document de référence la liste en dur des règles path-gated, au motif qu'une copie en dur diverge au premier ajout ou retrait d'un frontmatter. Le principe est juste et le corps de la PR le dit correctement (la liste était exacte et redondante, pas fausse).

Mais le mécanisme reste vivant dans le fichier voisin : CLAUDE.md §Règles modulaires énumère les règles path-gated par domaine (Notebooks / Catalogue & README / Artefacts / GenAI / Lean / Python). C'est exactement la copie en dur que #23385 retire deux fichiers plus loin.

Mesure au 2026-10-30

  • Règles portant un frontmatter paths: : 14.
  • Noms cités par les lignes de table de CLAUDE.md : 17, dont les 14 path-gated → la table est complète aujourd'hui.
  • Le point de morsure est le 15ᵉ path-gated : à ce jour-là, CLAUDE.md sera silencieusement incomplet, et aucune garde ne compare cette table au disque.

CLAUDE.md documente cette redondance comme voulue (l. 72 : « le tableau ci-dessus et le §C en sont le précis toujours chargé, pas une redondance »). Ce n'est donc pas un défaut de #23385, et cette issue ne le conteste pas.

Proposition

Une demi-phrase dans CLAUDE.md §Règles modulaires, sans réécrire la table :

Le précis par domaine ci-dessous est une vue datée ; la commande fait foi.

Le corps de la PR #23385 donne déjà la commande de référence (grep -l '^paths:' .claude/rules/*.md, 14/14 aujourd'hui, et 0 occurrence de paths: en début de ligne hors frontmatter — mesuré ce jour : les deux notions coïncident exactement, la divergence est latente).

Pourquoi une issue et pas un correctif dans #23385

  1. CLAUDE.md est le fichier de règles : toute modification y relève de la gouvernance §A (PR + review, et sign-off user si la modification est substantielle). Le caractère « demi-phrase de qualification » d'une vue de table n'ajoute ni obligation ni interdiction — mais la décision de fond (faire ou non figer cette table) appartient au coordinateur et au mainteneur, pas à la lane qui tient la relecture.
  2. Docs(harness,#7423): retire la liste en dur des regles path-gated (passe de coherence cross-fichiers, axes mesures) #23385 a un périmètre : le document de référence. Elargir le périmètre à CLAUDE.md sur une PR déjà revue la ferait rebasifier pour rien.

Ce qui reste à trancher

  • La demi-phrase est-elle acceptée telle quelle, ou faut-il un garde (un check qui compare la table de CLAUDE.md au disque) ?
  • Le cas échéant, ce garde est-il dans scripts/ci/ (un check qui peut rougir → guard) ou dans un job d'audit ?

Part of #7423 · signalé par la relecture de #23385

Activity

  1. changed the title [-]Docs(harness): CLAUDE.md §Règles modulaires -- dire que le tableau par domaine est une vue dated (la commande fait foi)[/-] [+]Docs(harness): CLAUDE.md §Règles modulaires -- dire que le tableau par domaine est une vue datée (la commande fait foi)[/+] on Oct 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions