Harness Designer v4

Que fait Harness Designer v4 ?

Principe : « Donnez une carte à l'agent, pas un manuel de 1000 pages. » — OpenAI Harness Engineering Principe : « Ne laissez pas le générateur évaluer son propre travail. » — Anthropic GAN-Inspired Harness

Les 5 Piliers de Conception du Harnais

Tout espace de travail généré par cette compétence doit satisfaire aux cinq piliers suivants :

Pilier	Question Clé	Principe
Disclosure Progressive	L'agent peut-il voir uniquement ce dont il a besoin ?	Table des matières (~100 lignes) → Pointeur → Document détaillé
Application Mécanique	Les règles sont-elles appliquées mécaniquement ?	La documentation seule ne garantit pas la cohérence
Boucle de Rétroaction	L'échec permet-il une amélioration structurelle ?	« Pas plus d'effort, mais quelle capacité manque-t-il ? »
Continuité de Session	Le transfert entre sessions est-il propre ?	progress + feature-status + git
Gestion de l'Entropie	La structure se maintient-elle dans le temps ?	Nettoyage périodique, validation de la fraîcheur des documents

---

Relation entre les Deux Couches

┌─────────────────────────────────────────────────────┐
│  COUCHE 1 : Méta (rôle de cette compétence)         │
│                                                     │
│  Planificateur ──→ Générateur ──→ Évaluateur        │
│     ↑            (unidirectionnel, pas de retour) │
│     └──── Rétroaction si insuffisant ───────────┘  │
│                                                     │
│  Objectif : Concevoir, générer et valider la         │
│             structure de l'espace de travail         │
└─────────────────────────┬───────────────────────────┘
                          │ Structure complétée après validation
                          ▼
┌─────────────────────────────────────────────────────┐
│  COUCHE 2 : Opérationnelle (rôle de l'espace de      │
│             travail finalisé)                         │
│                                                     │
│  ┌ Initialiseur (première exécution uniquement)      │
│  │ → Configuration de l'environnement                │
│  │                                                  │
│  └ Agent Opérationnel (exécution répétée) :          │
│    Agent-A ─┐                                       │
│    Agent-B ─┼──→ Président Synthèse ──→ Livrable    │
│    Agent-C ─┘  (parallèle indépendant, sans échange  │
│                entre agents)                          │
│                                                     │
│  Objectif : Effectuer les tâches réelles              │
│             (analyse, prise de décision, rapports)    │
└─────────────────────────────────────────────────────┘

---

COUCHE 1 : Méta — Processus de Conception du Harnais

Les 3 Agents L1 (Unidirectionnel, Pas de Retour Arrière)

Le flux suit l'ordre : Planificateur → Générateur → Évaluateur. Chaque agent reçoit uniquement le résultat de l'étape précédente et n'anticipe pas le résultat de l'étape suivante.

Planificateur (Agent de Planification)

Analyse l'intention de l'utilisateur et conçoit la structure du harnais.

• Entrée : Exigences de l'utilisateur (collectées via des questions)
• Sortie : Proposition de composition des agents + ébauche de structure de dossiers + proposition de critères d'évaluation
• Contrainte : Conçoit avant de voir les résultats du Générateur et de l'Évaluateur

Générateur (Agent de Construction)

Transforme le plan du Planificateur en fichiers réels.

• Entrée : Plan approuvé par le Planificateur
• Sortie : Fichiers .md/.json réels (voir Phase 2 pour la liste complète)
• Contrainte : Construit sans voir les critères de l'Évaluateur au préalable

Évaluateur (Agent d'Évaluation)

Valide indépendamment les résultats du Générateur.

• Entrée : Fichiers générés par le Générateur + critères d'évaluation du Planificateur
• Sortie : Score basé sur les 5 piliers + résultats de validation fonctionnelle + suggestions d'amélioration
• Contrainte : N'évalue que le résultat, sans tenir compte de l'intention du Générateur

---

L1 Phase 0 : Correspondance de Motifs — Référence à harness-100 (Nouveau v4.1)

« 99% des bonnes conceptions ont déjà été faites par quelqu'un d'autre. Trouvez-les et adaptez-les. »

Avant d'entrer dans la Découverte, recherchez parmi les 73 exemplaires validés de harness-100 (https://github.com/revfactory/harness-100, Apache-2.0) le plus similaire pour l'utiliser comme référence. Pour les non-développeurs, orienter vers la compétence harness-starter-workspace.

Exemplaires Cibles (Domaines d'Espace de Travail, 73 au total)

• Contenu #01–15, Entreprise #43–55, Éducation #56–65, Juridique #66–72, Style de Vie #73–80, Documentation #81–88, Opérations #89–95, Spécialisé #96–100

Procédure de la Phase 0

1. Extraire les mots-clés du domaine à partir de la demande de l'utilisateur (1 à 2 phrases)
2. Proposer les 3 meilleurs candidats parmi les 73 ci-dessus + obtenir la confirmation de l'utilisateur
3. Enregistrer le numéro de l'exemplaire choisi dans le champ reference_exemplar du fichier _workspace/00_input.md
4. Si la similarité de correspondance < 0.5 → Repli vers le mode de conception libre (passer à la Phase 1 existante)

Intégration du Résultat de la Phase 0 dans les Étapes Suivantes

• Planificateur : Utiliser la composition de 4 à 5 spécialistes + Réviseur de l'exemplaire comme base
• Générateur : Forcer le squelette de l'exemplaire, la convention de numérotation des fichiers _workspace/NN_*.md
• Évaluateur : Utiliser les 8 Normes de Qualité de l'exemplaire (Mode d'Équipe d'Agents / Expertise du Domaine / Sorties Structurées / DAG de Dépendances / Gestion des Erreurs / Modes d'Échelle / Scénarios de Test / Limites de Déclenchement) comme rubrique

Fidélité au Motif (Évaluation Qualitative, Limité à la Phase 0)

Ne fait pas partie de la notation automatique des 5 piliers. Évalué qualitativement lors de la correspondance de motifs de la Phase 0.

Vérifier séparément la notation de l'Évaluateur pour les 8 Normes de Qualité de l'exemplaire choisi pendant la Phase 0 (Mode d'Équipe d'Agents / Expertise du Domaine / Sorties Structurées / DAG de Dépendances / Gestion des Erreurs / Modes d'Échelle / Scénarios de Test / Limites de Déclenchement).

• Moment d'application : Une fois pendant la Phase 0 (sélection de l'exemplaire), une fois après la validation de l'Évaluateur lors du rapport
• Pas de notation : N'est pas inclus dans la notation des 22 items des 5 piliers
• Pillar-weight : Seuls les poids des 5 piliers peuvent être ajustés. La Fidélité au Motif n'est pas soumise à la pondération

Réviseur Obligatoire

La couche opérationnelle doit inclure un agent Réviseur (rôle de validation croisée). Ajouter une étape de validation croisée du Réviseur au modèle de synthèse du Président existant.

Limites de Déclenchement (should + NOT)

Le Planificateur/Générateur doit inclure une section should-NOT trigger dans le fichier orchestrator skill.md généré.

Injection du Cadre du Domaine

Injection automatique de cadres validés par catégorie :

• Contenu : AIDA, Pattern Interrupt, formule CURVE
• Entreprise : BMC, TAM/SAM/SOM, 5 Forces de Porter, RICE, Van Westendorp PSM
• Éducation : Taxonomie de Bloom, ADDIE, CECR, SM-2, Modèle de Toulmin
• Juridique : IRAC, MQM, RGPD/PIPA, IPC/CPC
• Style de Vie : BMR/TDEE, Lignes directrices de l'ACSM, Intérêts composés
• Documentation : Diataxis, PREP, STAR, MADR, SemVer
• Opérations : SIPOC/RACI, Cadre 4C, SMART, NPS/CSAT, BARS
• Spécialisé : Protocole GHG, Cap Rate/IRR, IMRaD, Georgia-Pacific, Double Materiality

---

L1 Phase 1 : Découverte — Fonctionnement du Planificateur

La Découverte se compose de 4 étapes de questions. Chaque étape est traitée séquentiellement, avec des questions de suivi qui bifurquent en fonction des réponses de l'utilisateur. Ne passez à l'étape suivante qu'après avoir reçu la réponse à l'étape en cours. Ne posez pas toutes les questions en même temps.

1-1. Étape 1 — Objectif et Contexte (POURQUOI / QUI)

L'objectif est de comprendre la raison d'être de l'espace de travail, pas sa structure.

W1. Quel problème cet espace de travail doit-il résoudre ?
    (Quelle décision/analyse/jugement pose actuellement problème ?)

W2. Qui l'utilise ?
    (Agents uniquement / Agents + Humains / Humains consomment les résultats)
    → Suivi : Quel est le niveau d'expertise domaine de l'utilisateur ?

W3. Quel est le critère de succès de cet espace de travail ?
    (Quel résultat indiquerait qu'il a été « bien conçu » ?)

W4. Existe-t-il un processus similaire existant ?
    (Est-ce un remplacement ou une création ?)
    → Suivi [Remplacement] : Quel est le plus gros problème du processus existant ?
    → Suivi [Nouveau] : Existe-t-il un système de référence ?

Bifurcation des Questions de Suivi :

• W2 « Humains consomment les résultats » → « Quel est le poste/rôle de la personne qui reçoit les résultats ? Quel format préfère-t-elle ? »
• W3 Réponse vague → « Spécifiquement, quel livrable serait un succès ? »

1-2. Étape 2 — Livrables et Structure (QUOI)

Qu'est-ce qui est créé ? Quelles perspectives sont nécessaires ?

S1. Quel est le livrable final ?
    (Rapport / Compte-rendu de décision / Rapport d'analyse / Proposition)

S2. Quel est le modèle de travail répétitif clé ?
    (Entrée → Analyse → Décision → Enregistrement → Accumulation de connaissances)

S3. Combien de perspectives/rôles sont nécessaires ? Quel est le caractère de chacun ?
    (Ex : Optimiste/Pessimiste/Données/Expérience/Réglementation — conflit/complémentarité)
    → Suivi : Y a-t-il une priorité entre les perspectives ? Sont-elles égales ?

S4. Un Président (rôle de synthèse) est-il nécessaire ?
    (Responsable de la session principale / Agent séparé / Non nécessaire)
    → Suivi [Nécessaire] : Quelle est la composition du modèle d'agent ?
      → Proposer après consultation de references/agent-archetypes.md

S5. Quel est le format de l'entrée ?
    (Saisie de texte directe / Téléchargement de fichier / URL / Format composite)

S6. Quels sont les résultats à conserver ?
    (Fichiers de session / Comptes-rendus de décision / Accumulation de connaissances / deep-research)

Bifurcation des Questions de Suivi :

• S3 5 perspectives ou plus → « Ces perspectives peuvent-elles être regroupées ? Séquentielles ou parallèles ? »
• S4 « Agent séparé » → « Quel est le cadre de décision du Président ? Go/Pivot/No-Go ? »

1-2.5. Étape 2.5 — Gestion des Connaissances (SAVOIR) [Conditionnel]

Option wiki pour les espaces de travail de recherche multi-agendas afin de référencer systématiquement les recherches existantes. Ignorer pour les espaces de travail à agenda unique ou non-recherche.

K1. « Avez-vous besoin de référencer les recherches existantes dans les recherches ultérieures lorsque vous menez plusieurs agendas (sujets de recherche) ? »
    → « Non » → Pas de wiki. Passer à l'Étape 3.
    → « Oui » → Aller à K2.

K2. Vérifier l'installation de la compétence /graphify (détection automatique)
    - Vérifier l'existence de ~/.claude/skills/graphify/ ou .claude/skills/graphify/
    - Installée → Aller à K3.
    - Non installée → Fournir l'explication :
      ┌─────────────────────────────────────────────────┐
      │ Le wiki est généré par la compétence /graphify. │
      │ Sans cette compétence, le wiki ne peut pas être    │
      │ créé.                                           │
      │                                                 │
      │ Qu'est-ce que /graphify ?                       │
      │ - Analyse les documents/rapports pour créer      │
      │   un graphe de connaissances                     │
      │ - Découvre et visualise automatiquement les       │
      │   connexions entre concepts                      │
      │ - Génère automatiquement un document wiki basé    │
      │   sur la communauté                               │
      └─────────────────────────────────────────────────┘
      « Souhaitez-vous installer graphify ? »
      - Installation globale (~/.claude/skills/) [utilisable dans tous les projets]
      - Installation projet (.claude/skills/) [uniquement pour ce projet]
      - Ne pas installer → ⚠️ « La fonctionnalité wiki sera désactivée.
          Le dossier 45-wiki/ sera créé mais vide.
          Il pourra être généré ultérieurement avec /graphify puis /wiki-update. »
        → Inclure uniquement la structure du wiki, désactivée. Passer à l'Étape 3.

K3. « Où doit se trouver le dépôt du wiki ? »
    - À l'intérieur du projet (45-wiki/) [Par défaut]
    - Chemin externe spécifié

K4. « Souhaitez-vous que le wiki soit exploré automatiquement au début d'une nouvelle recherche ? »
    - Exploration automatique + référence après approbation de l'utilisateur [Par défaut]
    - Uniquement sur appel manuel (/wiki-ref)

Ajouts à la sortie du Planificateur (relatifs au wiki) :

• wiki_enabled: true/false
• wiki_location: "45-wiki/" ou chemin personnalisé
• wiki_auto_ref: true/false
• graphify_installed: true/false
• graphify_scope: "global" | "project" | "none"

⚠️ Protection de l'Indépendance des Références au Wiki :

• Interdiction absolue d'injecter le contenu du wiki dans l'agent de Phase A (recherche indépendante)
• Seulement autorisé pour l'agent de Phase B (Penseur Créatif) / Phase C (Président) après approbation de l'utilisateur
• Ne transmettre que des cadres/méthodologies/points de données, pas des conclusions
• Enregistrement obligatoire dans le livrable : wiki_ref, ref_approved_by, ref_approval_date

1-2.6. Étape 2.6 — Suivi de l'Historique des Modifications de Flux (HISTORIQUE DU FLUX) [Optionnel]

Recommandé pour les projets où le flux de travail devrait s'améliorer au fil du temps. Peut être ignoré pour les projets d'analyse ponctuelle.

F1. « Souhaitez-vous conserver un historique des modifications futures du flux de travail ? »

    Utilité :
    - Rétrospective sur l'évolution du projet (pourquoi cela a changé)
    - Justification pour un retour à une version antérieure
    - Référence pour la conception de projets similaires futurs

    ※ N'est pas destiné à être lu à chaque nouvelle session.
      Consulté uniquement lors de la modification, du retour en arrière ou du
      transfert du flux.

    → « Non » → Pas de 05-flow-history/. Passer à l'Étape 3.
    → « Oui » → Aller à F2.

F2. « Souhaitez-vous enregistrer automatiquement la version initiale (v1) comme enregistrement change 0001 ? »
    - Valeur par défaut : Oui (les réponses de la Découverte du Planificateur sont conservées comme justification de la conception)
    - Non → Créer uniquement le CHANGELOG, enregistrement manuel lors de la première modification

Principes de Gestion de l'Historique du Flux (après la création, pendant l'exploitation) : Cet historique enregistre uniquement les modifications du système de flux de travail (règles, procédures, outils, invites, commandes, scripts, CLAUDE.md). Les livrables créés par le système (résultats de recherche, rapports, analyses, enregistrements d'agenda) ne sont pas concernés. Critère de distinction : « Si ce changement n'avait pas eu lieu, le résultat de la prochaine exécution serait-il différent ? » → Oui = modification du système = enregistrement / Non = livrable = enregistrement non nécessaire Détails : 00-system/protocols/flow-change-protocol.md

Ajouts à la sortie du Planificateur (relatifs à l'historique du flux) :

• flow_history_enabled: true/false
• flow_history_initial_record: true/false (réponse à F2)

1-3. Étape 3 — Environnement et Outils (COMMENT)

Comment l'espace de travail sera-t-il opéré ?

H1. Quels outils d'IA sont utilisés ?
    (Claude Code / Desktop Claude / Autre)
    → La configuration du harnais diffère selon l'outil

H2. La continuité entre sessions est-elle nécessaire ?
    (Analyse ponctuelle / Projet à long terme / Sessions multiples)
    → Si « Long terme », inclure les livrables de transfert de session

H3. Quelle est la composition du modèle d'agent ?
    → Vérifier les modèles Claude actuels via une recherche web et proposer
    → Ne pas coder en dur le nom du modèle. L'utilisateur décide toujours.

H4. Quel est le niveau d'autonomie des agents ?
    (Vérification humaine à chaque fois / Décision autonome de l'agent + rapport / Entièrement autonome)

Bifurcation des Questions de Suivi :

• H2 « Long terme » → « Nombre de sessions prévu ? L'accumulation de connaissances est-elle importante ? »
• H4 « Entièrement autonome » → « Quels sont les critères d'escalade ? Dans quelles situations l'agent doit-il demander à un humain ? »

1-4. Étape 4 — Critères de Qualité et d'Évaluation (QUALITÉ / ÉVALUER)

Identifier les valeurs importantes pour l'utilisateur et se mettre d'accord sur les critères d'évaluation.

E1. Quels sont les attributs de qualité les plus importants pour cet espace de travail ? (Sélectionnez les 3 principaux)
    □ Profondeur d'analyse (perspicacité non superficielle)
    □ Indépendance (analyse indépendante sans influence mutuelle entre agents)
    □ Attribution claire des sources (conclusions fondées sur des preuves)
    □ Cohérence (maintien de la qualité entre sessions)
    □ Réactivité rapide (temps de traitement court)
    □ Évolutivité (facilité d'ajout d'agents/rôles)
    □ Documentation (traçabilité du processus et des résultats)
    □ Accessibilité utilisateur (un non-expert peut comprendre les résultats)

E2. Y a-t-il des plans d'expansion futurs ?
    (Aucun / Ajout de perspectives / Application à d'autres domaines / Renforcement de l'automatisation)

E3. Qu'est-ce qui ne doit absolument pas être compromis dans cet espace de travail ?
    (Ex : « Les agents ne doivent pas s'influencer mutuellement », « Aucune conclusion sans source »)

E4. Qu'est-ce qui peut être absent dans un premier temps ?

Bifurcation des Questions de Suivi :

• E1 « Indépendance » → « À quel niveau ? Interdiction même de partager les résultats ? Ou seulement l'analyse doit être indépendante ? »
• La réponse à E3 → Utilisée comme entrée clé pour la pondération de l'Évaluateur

1-5. Accord sur la Pondération de l'Évaluation (Après l'Étape 4)

Analyser les réponses des Étapes 1 à 4 pour proposer une pondération des 5 piliers. Se mettre d'accord avec l'utilisateur pour la finaliser.

[Processus de Proposition de Pondération]

ÉTAPE 1. Extraire les mots-clés des réponses des Étapes 1 à 4
  - « Indépendance essentielle » → Application Mécanique ↑
  - « Projet à long terme » → Continuité de Session ↑, Gestion de l'Entropie ↑
  - « Réactivité rapide » → Disclosure Progressive ↑
  - « Attribution claire des sources » → Application Mécanique ↑

ÉTAPE 2. Ajuster à partir de la pondération par défaut et proposer

  Pondération par défaut (avant prise en compte des caractéristiques du projet) :
  | Pilier | Par défaut | Justification de l'ajustement | Proposition |
  |--------|------------|-------------------------------|-------------|
  | Disclosure Progressive | 20% | (Justification de la variation) | ?% |
  | Application Mécanique  | 25% | (Justification de la variation) | ?% |
  | Boucle de Rétroaction  | 20% | (Justification de la variation) | ?% |
  | Continuité de Session  | 15% | (Justification de la variation) | ?% |
  | Gestion de l'Entropie  | 20% | (Justification de la variation) | ?% |

  « Pour ce projet, compte tenu de [justification],
   le poids du pilier [nom] a été ajusté de [défaut]% → [proposition]%.
   Avez-vous des commentaires ou des modifications à suggérer ? »

ÉTAPE 3. Intégrer les retours de l'utilisateur
  - Accord → Finalisé
  - « Augmente l'indépendance » → Augmenter l'Application Mécanique, réduire d'autres piliers, puis re-proposer

ÉTAPE 4. Approbation finale
  → Utiliser la pondération convenue au lieu de la pondération par défaut dans evaluator-protocol-workspace.md

1-6. Correspondance Automatique des Motifs

Recommandation automatique de motif de dossier basée sur les réponses de l'Étape 2 :

Mot-clé de la Réponse de l'Utilisateur	Motif Recommandé	Référence
Analyse, Investissement, Décision, Jugement	Motif A (Analyse & Décision)	folder-patterns.md
Construction, Processus, Devis, BTP	Motif B (Construction & Gestion de Projet)	folder-patterns.md
Recherche, Contenu, Rapport	Motif C (Recherche & Contenu)	folder-patterns.md
Codage Long Terme, Automatisation, Build	Motif D (Agent Long Terme)	folder-patterns.md

1-7. Livrables du Planificateur

① Résumé du Contexte du Projet — Objectif, utilisateur, critères de succès, contraintes clés (basé sur Étapes 1-2) ② Proposition de Composition des Agents — Rôles, personnalités, affectation des modèles ③ Ébauche de Structure de Dossiers — Correspondance de motifs + personnalisation ④ Conception de la Continuité de Session — Méthode de transfert décidée (ponctuel / utilisation de progress.json) ⑤ Stratégie d'Extension — Décisions de conception pour les extensions futures (basé sur Étape 4 E2) ⑥ Critères d'Évaluation + Pondération Convenue — Liste de contrôle des 5 piliers + tableau de pondération

[Planificateur terminé — Demande d'approbation de l'utilisateur]
Veuillez examiner les points ① à ⑥ et indiquer toute modification.
Une fois approuvé, le Générateur commencera la construction.

---

L1 Phase 2 : Construction — Fonctionnement du Générateur

Après l'approbation du livrable du Planificateur, générer les fichiers dans l'ordre ci-dessous. Le Générateur crée à la fois la structure des dossiers et le contenu des fichiers.

2-1. Diagramme de Flux de Travail (Mermaid)

Diagramme représentant les deux couches, incluant la boucle de reconception Évaluateur → Planificateur :

flowchart TD
    USER[Utilisateur] -->|Exigences| P
    subgraph L1[Layer 1 : Méta]
        P[Planificateur] --> G[Générateur]
        G --> E[Évaluateur]
        E -->|Insuffisant 70~89%| G
        E -->|Reconception < 70%| P
        E -->|Approuvé 90%+| DONE[Structure complétée]
    end
    DONE --> INIT
    subgraph L2[Layer 2 : Opérationnel]
        INIT[Initialiseur
        Première exécution uniquement] --> OP
        subgraph OP[Exécution répétée de l'Agent Opérationnel]
            INPUT[Entrée] --> SPLIT[ ]
            SPLIT --> A1[Agent-A]
            SPLIT --> A2[Agent-B]
            SPLIT --> A3[Agent-C]
            A1 --> CH[Président Synthèse]
            A2 --> CH
            A3 --> CH
            CH --> OUT[Sortie + Sauvegarde d'état]
        end
    end

2-2. Création des Livrables Clés (Dans l'Ordre)

Ordre	Livrable	Fichier de Référence	Remarque
2-2a	WORKSPACE_TREE.md	folder-patterns.md	Structure de dossiers finalisée
2-2b	CLAUDE.md (~100 lignes)	claude-md-template.md	Rôle de table des matières, table de routage de référence obligatoire
2-2c	AGENTS.md	(Guide interne de cette compétence)	Règles d'exploitation des agents + model_config
2-2d	Fichiers de rôles des agents	agent-archetypes.md	00-system/prompts/*.md
2-2e	5 protocoles	(Guide interne de cette compétence)	00-system/protocols/
2-2f	Livrables de transfert de session	session-handoff.md	progress.json + feature-status.json
2-2g	Règles impératives	enforcement-patterns.md	Règles vérifiables structurellement
2-2h	Commandes slash	(Basé sur la conception du Planificateur)	.claude/commands/*.md
2-2i	README.md	(Guide utilisateur)	Démarrage rapide + commandes + dépannage
2-2j	Wiki d'historique des modifications de flux (Optionnel)	flow-history-template.md	Uniquement si F1=Oui à l'Étape 2.6

2-2b. Règles de Rédaction du CLAUDE.md (Très Important)

→ Voir references/claude-md-template.md. Doit faire moins de 100 lignes.

CLAUDE.md est le point d'entrée de l'agent. Des instructions trop longues deviennent des « non-directives » :

• Le contexte écrase la tâche et le code
• L'agent tombe dans la correspondance de motifs locale au lieu d'une exploration intentionnelle
• Les documents monolithiques vieillissent rapidement

Doit absolument inclure :

• Identité de l'espace de travail (3 lignes)
• Tableau de composition des agents
• Table de routage de référence ← Clé de la Disclosure Progressive
• Pointeur vers le principe d'indépendance
• Liste des commandes

Format de la Table de Routage de Référence :

## Routage de Référence
| Situation | Fichier à Lire |
|-----------|----------------|
| Vérifier le rôle d'un agent | → 00-system/prompts/[role].md |
| Règles de déroulement de la discussion | → 00-system/protocols/council-protocol.md |
| Détail du principe d'indépendance | → 00-system/protocols/independence-protocol.md |
| Vérifier l'état de la session | → progress.json |
| État d'achèvement des fonctionnalités | → feature-status.json |

2-2c. Règles de Rédaction du AGENTS.md

Doit absolument inclure :

• Tableau de la liste des agents de la Couche 2 (rôle / modèle / condition d'activation)
• Section model_config (modèle choisi par l'utilisateur + déclencheur de révision)
• Méthode de synthèse du Président + cadre de décision (Go/Pivot/No-Go)
• Résumé du principe d'indépendance
• Règles de gestion de contexte (durée de vie du contexte, seuil de résumé, procédure de continuation)

2-2d. Fichiers de Rôles des Agents (00-system/prompts/*.md)

Créer des fichiers séparés par rôle d'agent. Chaque fichier doit inclure :

• Portée et limites (ce que l'agent fait et ne fait pas)
• Méthode d'analyse ou cadre
• Format de sortie (format de document structuré)
• Règles de référence (comment consulter le Président ou d'autres agents)

Modèle de base :

# Rôle : [Nom de l'Agent]

## Portée
Tu es [nom] dans cet espace de travail. Ton objectif est de [tâche].

## Méthode de Travail
1. Analyser l'entrée en utilisant [cadre]
2. Exploiter [connaissances/spécialisation]
3. Générer la sortie selon [format]

## Limites
- **Ne pas** interférer avec les résultats des autres agents
- **Ne pas** déduire ou supposer
- **Utiliser uniquement** les informations données

## Format de Sortie
[Format de sortie standardisé]

2-2e. 5 Protocoles (00-system/protocols/)

Créer les 5 protocoles de base suivants :

Protocole	Contenu
council-protocol.md	Règles de déroulement de la discussion des agents + conditions de convocation/suspension du Président
independence-protocol.md	Interdiction de transfert d'informations entre agents + règles de soumission au Président
session-handoff.md	Procédure de transfert de session (lecture/écriture de progress.json)
evaluator-protocol.md	Cycle d'évaluation automatique + critères de déclenchement de la reconception
escalation-protocol.md	Critères de passage en mode supervision humaine (situations de non-respect des contraintes de sécurité/règles)

2-2f. Livrables de Transfert de Session

progress.json + feature-status.json doivent être générés et conservés à la racine de l'espace de travail. Utiliser le format de session-handoff.md.

2-2g. Règles Impératives

Créer des règles de validation structurelle dans enforcement-patterns.md :

• Règle de vérification de l'intégrité de la structure des dossiers
• Règle de vérification de la table de routage de référence de CLAUDE.md
• Règle de traçabilité des livrables
• Règle de vérification de l'indépendance

2-2h. Commandes Slash

Générer les commandes slash dans .claude/commands/*.md en fonction de la conception du Planificateur. Commandes de base obligatoires :

• /status : Voir l'état actuel de l'espace de travail
• /handoff : Générer un livrable de transfert de session
• /evaluate : Exécuter l'évaluation
• /report : Générer le rapport final actuel
• /escalate [raison] : Demander une supervision humaine

2-2i. README.md

Guide de démarrage rapide pour un nouvel utilisateur :

• Mécanisme de consultation de la table des matières via CLAUDE.md (~100 lignes)
• Liste des commandes
• Interprétation de la structure des dossiers
• Procédure de résolution des problèmes courants

2-2j. Wiki d'Historique des Modifications de Flux (Conditionnel)

Uniquement si l'utilisateur a accepté le suivi de l'historique du flux à l'Étape 2.6. Utiliser flow-history-template.md et enregistrer la version initiale (change 0001).

---

L1 Phase 3 : Évaluation — Fonctionnement de l'Évaluateur

3-1. Grille d'Évaluation Basée sur les 5 Piliers

Notation pour chaque pilier (10 points maximum, note de passage = 9 points/90% par pilier) :

1. Disclosure Progressive (10 pts)

Critère	Description	Barème (pts)
CLAUDE.md ≤ 100 lignes	Fonctionne comme table des matières	2
Table de routage de référence	Les chemins de tous les documents sont listés	3
Hiérarchie de profondeur	Structure en 3 couches : résumé → pointeur → détail	3
Aucun contenu dupliqué	Pas de duplication entre fichiers	2

2. Application Mécanique (10 pts)

Critère	Description	Barème (pts)
Règles impératives	Fichier enforcement-patterns.md avec règles vérifiables	3
Isolation des agents	Protocole independence-protocol.md spécifié	2
Format de sortie structuré	Format spécifié par agent	2
Validation automatique possible	Au moins 1 règle pouvant être scriptée	3

3. Boucle de Rétroaction (10 pts)

Critère	Description	Barème (pts)
Critère de reconception	Seuil de déclenchement de la reconception défini	3
Stockage de l'état	progress.json avec état de complétion	2
Espace de travail Inbox	Emplacement de dépôt des retours	2
Déclencheur d'évaluation	Condition de réexécution de l'évaluation	3

4. Continuité de Session (10 pts)

Critère	Description	Barème (pts)
Procédure de handoff	Logique de lecture/écriture de progress.json documentée	3
feature-status.json	Statut de chaque fonctionnalité suivi	2
Portée du contexte	Règles de rafraîchissement du contexte définies	2
Procédure de reprise	Procédure après une interruption pendant la session	3

5. Gestion de l'Entropie (10 pts)

Critère	Description	Barème (pts)
Plan de nettoyage	Procédure de nettoyage des fichiers obsolètes	2
Vérification de la fraîcheur	Mécanisme de vérification de l'actualité des documents	2
Règle d'archivage	Critères de déplacement en archive	2
Journal des modifications	Enregistrement des modifications de l'espace de travail	2
Cycle de révision	Cycle de révision automatique défini	2

3-2. Seuils de Décision de l'Évaluation

Total	Décision	Action
≥ 90% (moyenne des 5 piliers)	PASS	Exécuter immédiatement la compétence cartesian-review (si installée) pour une vérification supplémentaire
70~89%	Révision	Renvoyer au Générateur pour amélioration après identification des lacunes
< 70%	Reconception	Retourner au Planificateur, réexécuter la Phase 1 Découverte

3-3. Livrable de l'Évaluateur

Format de rapport fixe :

# Rapport d'Évaluation

**Date :** [Date]
**Cible d'évaluation :** [Répertoire de l'espace de travail]

## 1. Tableau des Scores par Pilier

| Pilier | Score | Déficit |
|--------|-------|--------|
| Disclosure Progressive | ?/10 | - |
| Application Mécanique | ?/10 | - |
| Boucle de Rétroaction | ?/10 | - |
| Continuité de Session | ?/10 | - |
| Gestion de l'Entropie | ?/10 | - |
| **Total** | **?/50** | **PASS/RÉVISION/RECONCEPTION** |

## 2. Résultat de la Vérification Fonctionnelle
- [ ] La table de routage de référence de CLAUDE.md est fonctionnelle
- [ ] Tous les fichiers de protocole existent
- [ ] Les commandes slash sont disponibles
- [ ] Le format de sortie structuré est spécifié
- [ ] Les règles d'indépendance sont spécifiées

## 3. Suggestions d'Amélioration
1. [Pilier] - [Problème spécifique]
2. [Pilier] - [Problème spécifique]

## 4. Décision Finale
**PASS / RÉVISION / RECONCEPTION**

3-4. Appel Automatique de cartesian-review

Si le score de l'Évaluateur ≥ 90% et que la compétence cartesian-review est installée, appeler immédiatement la compétence cartesian-review. La compétence cartesian-review exécute une révision de la qualité supplémentaire via 5 lentilles cartésiennes (Énumération, Évidence, Synthèse, Analyse, Doute Méthodique).

Vérification de l'installation :

ls ~/.claude/skills/cartesian-review/ 2>/dev/null && echo "Installé" || echo "Non installé"

Si non installé :

• Informer : « L'étape cartesian-review est sautée. Installez avec : git clone [URL de cartesian-review] ~/.claude/skills/cartesian-review/ »
• Le résultat PASS de l'Évaluateur est valide indépendamment

Processus d'appel :

1. L'Évaluateur transmet le chemin de l'espace de travail à cartesian-review
2. cartesian-review exécute sa propre évaluation et génère un rapport
3. Le rapport cartesian-review est stocké dans _workspace/60_cartesian_review.md
4. Si cartesian-review ne passe pas, un traitement séparé est requis

---

Informations Complémentaires

Variables d'Environnement

Nom	Description	Valeur par défaut
WORKSPACE_ROOT	Chemin de l'espace de travail courant	$PWD
EVALUATOR_THRESHOLD_PASS	Score de validation de l'Évaluateur	90
EVALUATOR_THRESHOLD_REVISE	Seuil de révision de l'Évaluateur	70
GRAPHIFY_SKILL_PATH	Chemin de la compétence graphify	~/.claude/skills/graphify/
CARTESIAN_REVIEW_SKILL_PATH	Chemin de la compétence cartesian-review	~/.claude/skills/cartesian-review/

Commandes

Commande	Description
/status	Afficher l'état actuel de l'espace de travail
/handoff	Générer un livrable de transfert de session
/evaluate	Exécuter l'évaluation de l'Évaluateur
/report	Générer le rapport final
/escalate [raison]	Demander une supervision humaine
/wiki-ref [sujet]	Consulter le wiki (si configuré)
/wiki-update	Mettre à jour / reconstruire le wiki (nécessite graphify)

Fichiers et Chemins

• _workspace/00_input.md : Enregistrement de la demande de l'utilisateur + résultats de la Phase 0
• _workspace/05_design_decisions.md : Décisions de conception prises pendant la Découverte
• _workspace/10_planner_output.md : Livrables du Planificateur
• _workspace/20_approved_plan.md : Planificateur approuvé → transmis au Générateur
• _workspace/30_generated_files.md : Liste des fichiers générés par le Générateur
• _workspace/40_evaluator_report.md : Rapport de l'Évaluateur
• _workspace/50_weight_agreement.md : Tableau de pondération convenu
• _workspace/60_cartesian_review.md : Rapport de cartesian-review (si exécuté)
• progress.json : État de progression de la session en cours
• feature-status.json : Statut de complétion des fonctionnalités

Intégration avec d'Autres Compétences

• harness-100 : Base de données de conception en libre accès utilisée en Phase 0
• cartesian-review : Étape de vérification supplémentaire de la qualité après validation de l'Évaluateur
• graphify : Génération du wiki de connaissance (conditionnel)
• harness-starter-workspace : Compétence simplifiée pour les non-développeurs