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¶
- Atomique — un seul end-state par critère, pas de "et"/"avec"
- Vérifiable — on peut pointer un fichier, requête, screenshot qui prouve
- 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