Socratic Brainstorm — Clarifier avant de coder
Skill inspiré de obra/superpowers. Objectif : forcer une phase de questions ciblées avant toute implémentation, pour éviter de coder la mauvaise chose très vite.
Règle d'or : une question coûte 30 secondes, un faux développement coûte 3 jours.
Méthode socratique : 5 familles de questions
À poser avant de toucher au code. Pas toutes à chaque fois — choisir les plus pertinentes selon le contexte.
1. Questions sur le PROBLÈME
- Quel est le vrai problème à résoudre ? (pas la solution supposée)
- Pour qui ? Quel persona / rôle utilisateur ?
- Quel est le coût de ne rien faire ?
- Comment mesurera-t-on le succès ? (KPI, métrique)
- Y a-t-il une solution plus simple qui résout 80% du besoin ?
2. Questions sur les CONTRAINTES
- Contraintes métier : règles légales, compliance, SLA ?
- Contraintes techniques : stack imposée, dépendances, legacy ?
- Contraintes temporelles : deadline, dépendances externes ?
- Contraintes ressources : budget infra, RH, maintenance long terme ?
- Que ne faut-il surtout pas casser ?
3. Questions sur les ALTERNATIVES
- Quelles sont les 3 approches possibles ? (minimum)
- Pourquoi celle-ci plutôt qu'une autre ?
- Qu'a-t-on déjà essayé / envisagé ?
- Existe-t-il une solution off-the-shelf (lib, SaaS) ?
- Peut-on ne rien coder (config, manuel, process) ?
4. Questions sur les HYPOTHÈSES
- Qu'est-ce qu'on suppose sans avoir vérifié ?
- Quel est le volume / trafic attendu ?
- Quel est le pattern d'usage réel (95% cas / 5% edge cases) ?
- Quels acteurs externes impliqués ? (API tierces, équipes, utilisateurs)
- Que se passe-t-il si cette hypothèse est fausse ?
5. Questions sur les CONSÉQUENCES
- Qu'est-ce qui change pour l'utilisateur final ?
- Impact sur les autres features / modules ?
- Coûts d'exploitation (infra, monitoring, support) ?
- Comment rollback si ça tourne mal ?
- Comment évolue cette solution dans 1 an, 3 ans ?
Output attendu
Après la phase brainstorm, produire une page (max) avec :
- Problème reformulé en 1-2 phrases
- Contraintes principales (5 bullets max)
- Option retenue + 2 alternatives rejetées avec raison
- Hypothèses clés à valider en début d'implémentation
- Risques identifiés + mitigations
Règles d'or
NE PAS sauter cette phase si :
- La demande initiale contient le mot "peut-être", "probablement", "je pense"
- Le demandeur n'est pas un utilisateur final
- Multiple solutions semblent possibles à première vue
- La feature touche du code legacy ou un domaine complexe
SAUTER cette phase si :
- Bug obvious avec un seul fix possible
- Typo / formatage / doc
- Tâche < 10 min avec périmètre trivial
Anti-patterns
| Anti-pattern |
Solution |
| Brainstorm infini sans décision |
Timebox 30 min max |
| Questions rhétoriques (réponse évidente) |
Questions ouvertes et utiles |
| Répondre soi-même sans demander |
Vraiment poser les questions au demandeur |
| Skip brainstorm "parce que c'est urgent" |
L'urgence coûte 10x le brainstorm évité |
| Noter les réponses dans sa tête |
Écrire = visible, revisitable, versionable |
Intégration Claude Craft
/workflow:analyze — phase d'analyse BMAD commence par ce skill
/workflow:plan — PRD doit répondre aux 5 familles de questions
- Agent
@product-owner — peut conduire le brainstorm avec le demandeur
- Skill
atomic-tasks — l'output du brainstorm se découpe en tâches atomiques
- Skill
architect — vient APRÈS le brainstorm pour les features architecturales
Variante rapide : "5 Whys"
Pour bugs ou causes racines, utiliser les 5 Whys de Toyota :
Bug: "Le paiement échoue"
Why 1: Pourquoi ? → L'API retourne 500
Why 2: Pourquoi ? → Timeout DB
Why 3: Pourquoi ? → Requête sans index
Why 4: Pourquoi ? → Colonne ajoutée sans migration d'index
Why 5: Pourquoi ? → Pas de checklist PR pour les migrations
Cause racine : absence de checklist, pas le 500.
Ressources
Date de dernière mise à jour : 2026-04-15
Version : 1.0.0
1---2name: socratic-brainstorm3description: Brainstorming socratique AVANT de coder - clarifier le problème par questions ciblées plutôt que sauter à la solution. Use when requirements are ambiguous or before starting a non-trivial feature.4context: fork5metadata:6 source: https://skillmd.com/skills/thebeardedbearsas/socratic-brainstorm7---89# Socratic Brainstorm — Clarifier avant de coder1011Skill inspiré de [obra/superpowers](https://github.com/obra/superpowers). **Objectif :** forcer une phase de questions ciblées avant toute implémentation, pour éviter de coder la mauvaise chose très vite.1213**Règle d'or :** une question coûte 30 secondes, un faux développement coûte 3 jours.1415## Méthode socratique : 5 familles de questions1617À poser **avant** de toucher au code. Pas toutes à chaque fois — choisir les plus pertinentes selon le contexte.1819### 1. Questions sur le PROBLÈME2021- Quel est le **vrai** problème à résoudre ? (pas la solution supposée)22- Pour qui ? Quel persona / rôle utilisateur ?23- Quel est le coût de **ne rien faire** ?24- Comment mesurera-t-on le succès ? (KPI, métrique)25- Y a-t-il une solution plus simple qui résout 80% du besoin ?2627### 2. Questions sur les CONTRAINTES2829- Contraintes **métier** : règles légales, compliance, SLA ?30- Contraintes **techniques** : stack imposée, dépendances, legacy ?31- Contraintes **temporelles** : deadline, dépendances externes ?32- Contraintes **ressources** : budget infra, RH, maintenance long terme ?33- Que ne faut-il **surtout pas** casser ?3435### 3. Questions sur les ALTERNATIVES3637- Quelles sont les 3 approches possibles ? (minimum)38- Pourquoi celle-ci plutôt qu'une autre ?39- Qu'a-t-on déjà essayé / envisagé ?40- Existe-t-il une solution off-the-shelf (lib, SaaS) ?41- Peut-on ne rien coder (config, manuel, process) ?4243### 4. Questions sur les HYPOTHÈSES4445- Qu'est-ce qu'on **suppose** sans avoir vérifié ?46- Quel est le volume / trafic attendu ?47- Quel est le pattern d'usage réel (95% cas / 5% edge cases) ?48- Quels acteurs externes impliqués ? (API tierces, équipes, utilisateurs)49- Que se passe-t-il si cette hypothèse est fausse ?5051### 5. Questions sur les CONSÉQUENCES5253- Qu'est-ce qui change pour l'utilisateur final ?54- Impact sur les autres features / modules ?55- Coûts d'exploitation (infra, monitoring, support) ?56- Comment rollback si ça tourne mal ?57- Comment évolue cette solution dans 1 an, 3 ans ?5859## Output attendu6061Après la phase brainstorm, produire **une page** (max) avec :62631. **Problème reformulé** en 1-2 phrases642. **Contraintes** principales (5 bullets max)653. **Option retenue** + **2 alternatives** rejetées avec raison664. **Hypothèses clés** à valider en début d'implémentation675. **Risques identifiés** + mitigations6869## Règles d'or7071### NE PAS sauter cette phase si :72- La demande initiale contient le mot "peut-être", "probablement", "je pense"73- Le demandeur n'est pas un utilisateur final74- Multiple solutions semblent possibles à première vue75- La feature touche du code legacy ou un domaine complexe7677### SAUTER cette phase si :78- Bug obvious avec un seul fix possible79- Typo / formatage / doc80- Tâche < 10 min avec périmètre trivial8182## Anti-patterns8384| Anti-pattern | Solution |85|--------------|----------|86| Brainstorm infini sans décision | Timebox 30 min max |87| Questions rhétoriques (réponse évidente) | Questions **ouvertes** et utiles |88| Répondre soi-même sans demander | Vraiment poser les questions au demandeur |89| Skip brainstorm "parce que c'est urgent" | L'urgence coûte 10x le brainstorm évité |90| Noter les réponses dans sa tête | Écrire = visible, revisitable, versionable |9192## Intégration Claude Craft9394- **`/workflow:analyze`** — phase d'analyse BMAD commence par ce skill95- **`/workflow:plan`** — PRD doit répondre aux 5 familles de questions96- **Agent `@product-owner`** — peut conduire le brainstorm avec le demandeur97- **Skill `atomic-tasks`** — l'output du brainstorm se découpe en tâches atomiques98- **Skill `architect`** — vient APRÈS le brainstorm pour les features architecturales99100## Variante rapide : "5 Whys"101102Pour bugs ou causes racines, utiliser les **5 Whys** de Toyota :103104```105Bug: "Le paiement échoue"106Why 1: Pourquoi ? → L'API retourne 500107Why 2: Pourquoi ? → Timeout DB108Why 3: Pourquoi ? → Requête sans index109Why 4: Pourquoi ? → Colonne ajoutée sans migration d'index110Why 5: Pourquoi ? → Pas de checklist PR pour les migrations111```112113**Cause racine :** absence de checklist, pas le 500.114115## Ressources116117- [obra/superpowers](https://github.com/obra/superpowers)118- [Socratic Method - Wikipedia](https://en.wikipedia.org/wiki/Socratic_method)119- [5 Whys - Toyota](https://en.wikipedia.org/wiki/Five_whys)120- Skill `atomic-tasks`, `architect`121122---123124**Date de dernière mise à jour :** 2026-04-15125**Version :** 1.0.0