Skip to content

[harness] Revue globale du harnais (CLAUDE.md + rules) — réécrire les parties vieillies, vision d'ensemble #7423

Description

@jsboige

Contexte (mandat user 2026-07-19)

« D'autres fichiers mériteraient également une MAJ, comme ceux de ton harnais. Le CLAUDE.md par exemple est mis à jour de temps à autre de façon incrémentale, mais sans vision globale et souci de réécrire les parties qui ont vieilli. »

Le harnais (CLAUDE.md projet, .claude/rules/*.md ~22 fichiers, MEMORY.md index) s'est construit par ajouts incrémentaux au fil des incidents. Résultat : des sections périmées (règles superseded, incidents résolus sur-cités, pointeurs docs/ morts), des redondances entre règles, et pas de vision d'ensemble. Une passe de cohérence globale est due — réécrire proprement les parties vieillies, pas empiler une couche de plus.

Distinct de #4208 : le harnais est de l'outillage interne (comment les agents travaillent), pas de la référence publique. Gouvernance ai-01, délibérée, non urgente.

Scope

  1. CLAUDE.md projet — relire section par section (A→H + cartographie + procédures) : détecter le périmé (règles superseded par un mandat plus récent, incidents résolus cités comme s'ils étaient chauds, pointeurs vers des docs/ déplacés), réécrire proprement les blocs vieillis.
  2. .claude/rules/*.md — passe de cohérence : redondances entre fichiers, contradictions résiduelles, règles obsolètes, pointeurs docs/ morts.
  3. Harness-hygiene 3-tiers (règle harness-hygiene) — vérifier que rien d'éphémère (PR#/SHA, log de cycle) n'a fui dans le harnais ; le détail durable doit vivre dans docs/ avec pointeur succinct.
  4. MEMORY.md index — pointeurs morts, entrées superseded, index >150 chars à trimmer.

Discipline (anti-pendule — HARD)

  • Cf CLAUDE.md global « Fixing Prompts and Rules — No Pendulum » : supprimer d'abord la ligne qui a vieilli ; n'ajouter un remplacement que si le retrait laisse un vrai trou non couvert ailleurs. Ne pas remplacer une ligne par son opposé.
  • Préserver avant de trimmer : merger le contenu durable dans sa cible (docs/) AVANT de couper la source, citer la cible comme preuve.

Acceptance

  • Diff de nettoyage cohérent (deletions justifiées, aucune perte de règle vivante).
  • Pointeurs docs/ re-vérifiés (0 lien mort).
  • Cohérence cross-fichiers (0 contradiction résiduelle entre CLAUDE.md et .claude/rules/).

Owner

ai-01 (le harnais pilote le comportement de tous les agents → passe coordinateur-owned, prudente, pas dispatchée à la légère). Non urgent — à caser entre les cycles de merge/dispatch.

Activity

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