Aller au contenu

ADR: index.shared.md — projection du tronc tracké (révision partielle ADR 2026-06-12)

Contexte

L'ADR 2026-06-12 garde index.md et log.md locaux : un catalogue auto qui liste tout l'écosystème fuiterait des noms de pages locales.

Le besoin d'un catalogue partagé pour les clones / cloud agents reste réel : sans index fiable, la récupération de contexte dérive.

Décision

  1. index.md reste gitignoré (index local complet, y compris pages locales non sensibles).
  2. index.shared.md est un nouveau fichier tracké, produit uniquement depuis le corpus déjà tracké et non restricted.
  3. Isolation avant traitement : le job LLM qui alimente index.shared.md reçoit un bundle explicite de fichiers autorisés ; il n'a pas accès au workspace ni à private/. Aucune sortie d'un job local ne peut alimenter l'index partagé.
  4. Gates mécaniques : pre-commit + CI + npm run test:leak-gate refusent tout chemin private/, .brain-local/, gitignoré ou restricted dans index.shared.md.
  5. log.md reste local (chronologie).

Cette ADR ne dé-gitignore pas meetings/, people/team/, ni journal/ (passe 2 de l'ADR 2026-06-12 — chantier séparé).

Conséquences

  • Les collègues et cloud agents disposent d'un catalogue du tronc partagé sans exposition nouvelle.
  • Les diffs de index.shared.md peuvent être bruyants à chaque régénération LLM ; un source_hash permet de détecter l'obsolescence sans relancer un LLM dans le pre-commit.
  • Artefacts de travail sous .brain-local/** (gitignoré + bloqué hooks + ruleset).

Sources