Aller au contenu

Méthodologie — Échange IA ↔ Marc

Comment Marc et Claude travaillent ensemble en session.

L'Algorithm PAI

Claude n'improvise pas : il suit un algorithme formel en 7 phases, documenté sous le nom Algorithm PAI v3.7.0.

flowchart LR
    START[Demande Marc] --> OBS[👁️ Observe]
    OBS --> THINK[🧠 Think]
    THINK --> PLAN[📋 Plan]
    PLAN --> BUILD[🔨 Build]
    BUILD --> EXEC[⚡ Execute]
    EXEC --> VERIFY[✅ Verify]
    VERIFY --> LEARN[📚 Learn]
    LEARN --> END[Livraison]

    classDef phase fill:#e87722,stroke:#0d1f3c,color:#fff
    class OBS,THINK,PLAN,BUILD,EXEC,VERIFY,LEARN phase

Rôle de chaque phase

Phase Ce que fait Claude
👁️ Observe Reverse-engineer la demande, poser les questions ouvertes, choisir l'effort level, définir les ISC
🧠 Think Premortem, identifier assumptions et prerequisites, raffiner les ISC
📋 Plan Architecture, séquence de tâches, dépendances, risques
🔨 Build Préparer l'environnement, invoquer les skills/agents sélectionnés
⚡ Execute Effectuer le travail, mettre à jour les ISC au fur et à mesure
✅ Verify Tester chaque ISC, marquer pass/fail, collecter les preuves
📚 Learn Réflexion, capture des leçons pour sessions futures

Les ISC — Ideal State Criteria

Un ISC = UNE chose atomique, vérifiable, binaire (pass/fail).

Règles

  1. Atomique : un seul end-state par critère, pas de "et", pas de "avec"
  2. Vérifiable : on peut pointer un fichier, une requête, un screenshot qui prouve
  3. Binaire : soit ✅ soit ❌, pas de "à moitié"

Exemple

❌ Mauvais : "DPE, BPE et loyers ANIL sont extraits et affichés"

✅ Bons : - ISC-1 : DPE ADEME extraits via API pour INSEE 91477 - ISC-2 : BPE 2024 extrait depuis fichier local pour INSEE 91477 - ISC-3 : Loyers ANIL joints sur commune dans log_01.py - ISC-4 : Template HTML affiche passoires avec source "ADEME DPE 2024" - ISC-A-1 : Aucun chiffre marqué "estimation" sans badge visuel (anti-critère)

Effort levels

Tier Budget temps ISC min Usage
Standard < 2 min 8-16 Demande simple
Extended < 8 min 16-32 Qualité extraordinaire nécessaire
Advanced < 16 min 24-48 Travail multi-fichiers substantiel
Deep < 32 min 40-80 Design complexe
Comprehensive < 120 min 64-150 Pas de pression temporelle

Claude classe automatiquement chaque demande.

Modes de réponse

Claude répond toujours dans un des 3 formats :

  • ALGORITHM — travail complexe multi-phase (ce document a été généré en mode Algorithm)
  • NATIVE — tâche simple (< 2 min)
  • MINIMAL — acquittements, ratings

Questions ouvertes vs exécution autonome

Claude exécute autonome quand : - La tâche est claire - Les prérequis sont là - Les choix techniques sont sans risque stratégique

Claude pose des questions quand : - Le scope est flou - Plusieurs approches sont défendables - Une donnée manque (genre ANIL) - Un choix business doit être tranché par Marc/Cyrille

Mémoire persistante

Claude maintient une mémoire par projet (.claude/projects/.../memory/) qui capture :

  • User memories : rôle, préférences de Marc
  • Feedback memories : corrections et validations reçues
  • Project memories : état des sprints, uploads, décisions
  • Reference memories : liens vers systèmes externes

Cette mémoire survit aux sessions : Claude se remet dans le contexte en lisant le MEMORY.md d'index.

Règles de base validées

  • Marc utilise un PC, le serveur est un Proxmox
  • Cyrille est l'expert métier urbaniste-data → ses études sont la spec
  • Données sensibles = repo privés (pas de GitHub Pages free)
  • Marc apprécie les visuels Mermaid
  • Ne jamais inventer une valeur numérique dans un rapport
  • Sur un red-team : failles sécu = ISC obligatoire, choix stratégiques = questions ouvertes

Voir aussi : Cyrille = source de vérité · Red-team handling