Aller au contenu

Méthodologie — Comment on sprint

Le mode de travail LObsTer : sessions Claude encadrées, sprints thématiques, traçabilité complète.

Dual-layer de la doc sprint

Chaque sprint est documenté à 2 endroits complémentaires :

Endroit Contenu Public
Wiki (ce site) — roadmap/sprint-*.md Stratégique : objectif, scope, spec Cyrille, dépendances, livrables attendus Marc + Cyrille + invités
Repo code demo-conductor/docs/sprints/sprint-*.md Technique : fichiers à toucher, SQL, commandes, tests Devs + Claude en session code

Les deux se réfèrent mutuellement. Règle : quand un sprint change (scope, livrables, dépendances), on met à jour les deux. Mini-duplication assumée pour éviter la désynchronisation.

Un sprint LObsTer ≠ un sprint Agile

Dans le vocabulaire LObsTer, un sprint est un chantier thématique cohérent qui peut durer de 30 minutes à plusieurs semaines. Ce n'est pas un sprint Agile standardisé sur 2 semaines.

Exemples de sprints :

  • Sprint 0 Wiki bootstrap (1 session, 2h)
  • Sprint 1 Refonte LOG-01 depuis HTML Cyrille (3-5 sessions, 1 semaine)
  • Sprint 4 Post-achat Stripe/Brevo (2 semaines)

Anatomie d'une session Claude

sequenceDiagram
    participant M as Marc
    participant IA as Claude
    participant PRD as PRD.md
    participant WIKI as Wiki

    M->>IA: Demande une tâche
    IA->>IA: Classe le mode (ALGORITHM / NATIVE / MINIMAL)
    IA->>IA: OBSERVE — reverse-engineer + effort level + ISC
    IA->>PRD: Crée PRD avec criteria
    IA->>M: Pose questions ouvertes si besoin
    M->>IA: Valide le plan
    IA->>IA: THINK + PLAN + BUILD
    IA->>IA: EXECUTE (implémente la tâche)
    IA->>PRD: Marque ISC au fur et à mesure ([x])
    IA->>IA: VERIFY chaque critère
    IA->>IA: LEARN réflexion
    IA->>WIKI: Met à jour le wiki si pertinent
    IA->>M: Livre le résultat

Les 3 modes d'exécution

Mode Quand Format réponse
ALGORITHM Tâche multi-étape complexe 7 phases formelles avec ISC
NATIVE Tâche simple < 2 min Format compact TASK/CHANGE/VERIFY
MINIMAL Acquittement, rating Ligne unique

Claude classe automatiquement à chaque début de session. Voir ~/.claude/CLAUDE.md pour les règles exactes.

Les 7 phases de l'Algorithm

flowchart LR
    O[👁️ Observe] --> T[🧠 Think]
    T --> P[📋 Plan]
    P --> B[🔨 Build]
    B --> E[⚡ Execute]
    E --> V[✅ Verify]
    V --> L[📚 Learn]

    classDef phase fill:#e87722,stroke:#0d1f3c,color:#fff
    class O,T,P,B,E,V,L phase
Phase Objectif Durée typique
👁️ Observe Reverse-engineer demande, choisir effort level, générer ISC 5-10% du budget
🧠 Think Premortem, risques, prérequis 5%
📋 Plan Architecture, séquence, dépendances 10%
🔨 Build Préparation env, invocation skills 5%
⚡ Execute Travail effectif 60%
✅ Verify Test de chaque ISC 10%
📚 Learn Réflexion pour sessions futures 5%

Niveaux d'effort

Tier Budget Min ISC Usage
Standard < 2 min 8-16 Demande simple (défaut)
Extended < 8 min 16-32 Qualité extraordinaire
Advanced < 16 min 24-48 Multi-fichiers substantiel
Deep < 32 min 40-80 Design complexe
Comprehensive < 120 min 64-150 Pas de pression temporelle

Le niveau est déterminé par Claude à partir du reverse engineering + ta contrainte temporelle.

Les ISC — Ideal State Criteria

Un ISC = UNE chose atomique, vérifiable, binaire.

Règles strictes

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

Splitting Test

Avant de finaliser un critère, Claude le passe à 4 tests :

Test Question Action si oui
And/With Contient "et", "avec", "incluant" ? Split
Independent failure Partie A peut passer tandis que B échoue ? Split
Scope word "Tous", "chaque", "complet" ? Énumérer
Domain boundary Traverse UI/API/data/logic ? 1 par boundary

Anti-ISC

Format ISC-A-N : ce qui ne doit PAS arriver.

Exemple : ISC-A-1 : Aucun chiffre dans le rapport sans source certifiée.

Le PRD — système de trace

Chaque session Claude crée un PRD.md dans ~/.claude/MEMORY/WORK/<slug>/.

Structure frontmatter

```yaml

task: Description 8 mots slug: YYYYMMDD-HHMMSS_kebab-description effort: deep phase: execute progress: 24/48 mode: interactive started: 2026-04-24T14:45:00+00:00 updated: 2026-04-24T15:30:00+00:00


```

Sections body

  • ## Context — pourquoi, risques, plan
  • ## Criteria — ISC checkboxes - [ ] / - [x]
  • ## Decisions — choix non-évidents pris pendant l'exécution
  • ## Verification — preuves de chaque ISC

Un dashboard externe

Chaque update du PRD déclenche un hook PRDSync qui met à jour work.json pour le dashboard Activity. Marc peut suivre l'avancée en temps réel.

Règle d'or : PRD avant code

Pour tout sprint Advanced+, Claude doit entrer en mode Plan (EnterPlanMode) et montrer le PRD + les ISC à Marc avant de toucher au code. Aucune exception.

Itérations

Une session peut itérer sur un PRD précédent :

  • Claude lit le PRD existant (frontmatter + ISC)
  • Incrémente le champ iteration: N+1
  • Ajoute/raffine les ISC
  • Continue l'exécution

Les itérations sont visibles dans le dashboard et dans le journal mémoire.

Voir aussi : Mémoire Claude · Cyrille source of truth