❓ WD Framework - FAQ & Troubleshooting

Réponses aux questions fréquentes et solutions aux problèmes courants

📖 Table des Matières

Questions Générales

Qu'est-ce que le WD Framework?

Réponse:

Le WD Framework est une extension intelligente de Claude Code qui ajoute:

22 commandes spécialisées
11 personas (experts IA)
5 agents (équipes autonomes)
Orchestration par vagues
Système de qualité (8 gates)
Coordination MCP servers

Analogie: C'est comme passer d'un développeur solo à une équipe d'experts coordonnés.

Comment ça fonctionne?

Réponse:

1. Vous → Commande (/wd:implement, /wd:improve, etc.)
         ↓
2. Orchestrator → Analyse la demande
   - Complexité
   - Domaine (frontend/backend/etc.)
   - Ressources nécessaires
         ↓
3. Activation automatique
   - Persona(s) approprié(s)
   - Agent(s) si nécessaire
   - MCP servers
   - Wave mode si complexe
         ↓
4. Exécution
   - Génération du code
   - Tests automatiques
   - Documentation
         ↓
5. Validation
   - 8 quality gates
   - Auto-fix si possible
         ↓
6. Résultat → Code prêt pour production

Est-ce gratuit?

Réponse:

Le WD Framework est gratuit et open-source (licence MIT).

Coûts possibles:

Tokens Claude Code (selon votre plan Anthropic)
MCP servers externes (certains peuvent avoir des coûts)

Estimation tokens:

Simple: 1-2K tokens (~$0.01-0.02)
Moyen: 5-10K tokens (~$0.05-0.10)
Complexe: 20-50K tokens (~$0.20-0.50)

💡 Astuce: Utilisez --uc pour économiser 30-50% de tokens!

Différence avec Claude Code standard?

Réponse:

Feature	Claude Code	WD Framework
Commandes	Génériques	22 spécialisées
Expertise	Généraliste	11 personas spécialisés
Coordination	Manuel	5 agents autonomes
Qualité	Basique	8 quality gates
Projets complexes	Limité	Wave orchestration
Optimisation	-	Auto-optimisation
Documentation	Manuel	Auto-générée

En résumé: WD Framework = Claude Code + Intelligence + Automation + Qualité

Utilisation

Quelle commande utiliser?

Réponse:

Guide de décision rapide:

Besoin de CRÉER quelque chose de nouveau?
   → /wd:implement

Besoin d'AMÉLIORER du code existant?
   → /wd:improve

Besoin de COMPRENDRE/ANALYSER?
   → /wd:analyze (pour analyser)
   → /wd:explain (pour expliquer)

Besoin de TESTER?
   → /wd:test

Besoin de DOCUMENTER?
   → /wd:document

Besoin de CORRIGER un bug?
   → /wd:troubleshoot

Besoin de MIGRER vers autre techno?
   → /wd:migrate

Besoin de CONCEVOIR l'architecture?
   → /wd:design

💡 En cas de doute: Utilisez /wd:implement avec une description claire. Le framework décidera automatiquement de la meilleure approche!

Améliorer la qualité des résultats?

Réponse:

5 techniques éprouvées:

Soyez spécifique dans votre demande

❌ /wd:implement formulaire
✅ /wd:implement Formulaire de contact avec validation email, captcha et envoi via API

Utilisez --ultrathink pour tâches complexes

/wd:implement Système de paiement --ultrathink

Activez wave mode pour qualité maximale

/wd:improve Refactoriser l'app --wave-mode force

Utilisez agents pour projets multi-domaines
```
/wd:implement Feature complète --agents
```
Combinez MCP servers
```
/wd:implement Dashboard --all-mcp
```

Bonus: Utilisez --wave-strategy enterprise pour production critique!

Quand utiliser --ultrathink?

Réponse:

Utilisez --ultrathink quand:

✅ Architecture complexe à concevoir
✅ Migration de framework
✅ Refactoring massif
✅ Optimisation critique de performance
✅ Sécurité critique (finance, santé)
✅ Décisions d'architecture importantes

N'utilisez PAS --ultrathink pour:

❌ Composants UI simples
❌ Petits bugs
❌ Documentation simple
❌ Tâches routinières

Coût: ~32K tokens (vs 2K standard) = 16x plus de réflexion

ROI: Pour tâches complexes, le gain en qualité compense largement le coût!

Économiser des tokens?

Réponse:

5 méthodes d'optimisation:

Mode Ultra-Compressed (--uc)
```
/wd:implement Simple feature --uc
```
Économie: 30-50% tokens

Soyez précis (évitez l'ambiguïté)

❌ "Fais quelque chose avec les utilisateurs"
✅ "Créer API CRUD pour utilisateurs"

Désactivez MCP si non nécessaire
```
/wd:implement --no-mcp
```
Utilisez --fast pour prototypes
```
/wd:implement Prototype rapide --fast
```

Batch similaires tasks

# Au lieu de 3 commandes séparées
/wd:implement Créer User, Product et Order components

Économie totale possible: 50-70% sur projets complets!

Annuler une opération?

Réponse:

3 méthodes selon le moment:

1. Pendant l'exécution:

# Ctrl+C dans le terminal
^C

2. Après génération (avant commit):

# Restaurer tous les fichiers
git restore .

# Restaurer un fichier spécifique
git restore path/to/file.ts

3. Après commit:

# Annuler le dernier commit (garde les changements)
git reset --soft HEAD~1

# Annuler et supprimer les changements
git reset --hard HEAD~1

Wave mode: Chaque vague crée un checkpoint. Vous pouvez restaurer à n'importe quelle vague.

💡 Best practice: Toujours commit avant d'utiliser le framework pour faciliter le rollback!

Personas & Agents

C'est quoi un persona?

Réponse:

Un persona est une personnalité d'expert spécialisé que le framework peut activer.

Les 11 personas:

🏛️  Architect   → Conçoit l'architecture
🎨  Frontend    → Expert UI/UX
🔧  Backend     → APIs et databases
🔒  Security    → Sécurité et vulnérabilités
⚡  Performance → Optimisation
🔍  Analyzer    → Analyse de code
✅  QA          → Tests et qualité
♻️  Refactorer  → Amélioration de code
🚀  DevOps      → Infrastructure
👨‍🏫  Mentor      → Explications pédagogiques
📚  Scribe      → Documentation

Ce qui change avec un persona:

Priorités différentes
Décisions différentes
Outils préférés différents
Validation différente

Exemple concret:

Tâche: "Améliorer le système de login"

Security Persona pense:
  - Vulnérabilités d'abord
  - Bcrypt cost factor 12+
  - Rate limiting
  - 2FA obligatoire

Performance Persona pense:
  - Temps de réponse <50ms
  - Cache des sessions
  - Index sur email
  - Connection pooling

→ Le framework COORDONNE les deux!

Différence persona vs agent?

Réponse:

Aspect	Persona	Agent
Nature	Comportement/Expertise	Équipe de travail
Rôle	Change comment on pense	Fait le travail
Nombre	11 disponibles	5 disponibles
Activation	Auto selon contexte	Manuel ou auto
Coordination	Travaillent ensemble	Parallèle/séquentiel

Analogie:

Persona = La mentalité de l'expert (architecte, security, etc.)
Agent = L'équipe qui exécute (frontend team, backend team, etc.)

Exemple:

# Utiliser le persona Security (mentalité sécurité)
/wd:analyze --persona-security

# Utiliser l'agent Security (équipe dédiée)
/wd:analyze --agent wd-security-agent

# Les deux
/wd:analyze security --persona-security --agent wd-security-agent

💡 Dans 90% des cas: Laissez le framework décider automatiquement!

Comment choisir un persona?

Réponse:

Option 1: Automatique (recommandé)

# Le framework détecte automatiquement
/wd:implement Login system
# → Active automatiquement Security + Backend personas

Option 2: Manuel

# Force un persona spécifique
/wd:improve Optimiser la page --persona-performance

Guide de sélection manuelle:

Focus SÉCURITÉ → --persona-security
Focus PERFORMANCE → --persona-performance
Focus UI/UX → --persona-frontend
Focus ARCHITECTURE → --persona-architect
Focus INFRASTRUCTURE → --persona-devops
Focus QUALITÉ → --persona-qa
Focus REFACTORING → --persona-refactorer
Focus EXPLICATION → --persona-mentor
Focus DOCUMENTATION → --persona-scribe

Combiner plusieurs personas:

# Possible mais rare
/wd:implement Payment system --persona-security --persona-backend

⚠️ Attention: Trop de personas peut créer des conflits. Laissez le framework gérer!

Créer mon propre persona?

Réponse:

Oui! C'est possible.

Étapes:

Créer le fichier

mkdir -p .wd/custom-personas
touch .wd/custom-personas/mon-persona.ts

Définir le persona

// .wd/custom-personas/mon-persona.ts
export const MonPersona: Persona = {
  name: 'mon-persona',
  description: 'Expert en...',

  priorities: [
    { name: 'ma_priorite_1', weight: 1.0 },
    { name: 'ma_priorite_2', weight: 0.9 }
  ],

  activationTriggers: {
    keywords: ['keyword1', 'keyword2'],
    filePatterns: ['*.ext'],
    contextual: (analysis) => {
      return analysis.mentions('condition');
    }
  },

  toolPreferences: {
    mcpServers: ['sequential'],
    agents: ['wd-backend-agent'],
    waveStrategy: 'systematic'
  },

  decisionLogic: {
    // Votre logique personnalisée
  }
};

Utiliser

/wd:implement Ma tâche --persona-mon-persona

Documentation complète: Voir Guide Avancé - Personnalisation

Orchestration

C'est quoi les vagues (waves)?

Réponse:

Les vagues sont une approche progressive en 5 étapes pour les tâches complexes.

Pourquoi? Au lieu de tout faire d'un coup (❌ risqué, incomplet), on fait par étapes (✅ qualité +30-50%).

Les 5 vagues:

🌊 Vague 1: ANALYSE (5 min)
   └─ Comprendre l'état actuel, identifier problèmes

🌊 Vague 2: CONCEPTION (5 min)
   └─ Designer la solution, planifier

🌊 Vague 3: IMPLÉMENTATION (10 min)
   └─ Coder avec validation continue

🌊 Vague 4: VALIDATION (5 min)
   └─ Tester, analyser, affiner

🌊 Vague 5: OPTIMISATION (5 min)
   └─ Finaliser, documenter, préparer déploiement

Analogie: Comme peindre une maison par couches (primaire → peinture → finitions) plutôt que tout en une fois.

Résultat: Chaque vague améliore le résultat de la précédente = Qualité supérieure!

Quand utiliser wave mode?

Réponse:

Wave mode s'active automatiquement quand:

Complexité ≥ 0.7
Plus de 20 fichiers affectés
Plus de 2 types d'opérations

Forcez wave mode pour:

✅ Refactoring complet
✅ Migration de framework
✅ Architecture refonte
✅ Optimisation approfondie
✅ Projets critiques (production)

N'utilisez PAS wave mode pour:

❌ Composants simples
❌ Bugs mineurs
❌ Prototypes rapides
❌ Petites modifications

Commande:

# Auto (framework décide)
/wd:implement --wave-mode auto

# Force
/wd:improve Refactor app --wave-mode force

# Désactiver
/wd:implement --wave-mode off

Trade-off: Wave mode = +temps mais +qualité (30-50%)

Différence entre les stratégies?

Réponse:

4 stratégies de vagues:

1. Progressive

Approche: Quick wins → Moyen → Complexe
Usage: Amélioration continue
Avantage: Résultats rapides, motivation

2. Systematic

Approche: Méthodique, checklist stricte
Usage: Compliance, standards stricts
Avantage: Qualité garantie, traçabilité

3. Adaptive

Approche: Apprentissage en cours, ajustements
Usage: Projets avec incertitudes
Avantage: Flexibilité, adaptation

4. Enterprise

Approche: Maximum qualité, validation exhaustive
Usage: Production critique, finance, santé
Avantage: Zero-defect, production-ready

Guide de sélection:

Projet PRODUCTION CRITIQUE
  → --wave-strategy enterprise

Projet avec STANDARDS STRICTS (compliance)
  → --wave-strategy systematic

Projet avec INCERTITUDES
  → --wave-strategy adaptive

Projet d'AMÉLIORATION CONTINUE
  → --wave-strategy progressive

Exemple:

/wd:implement Banking app --wave-mode force --wave-strategy enterprise

Performance

Combien de temps ça prend?

Réponse:

Estimation par complexité:

Type de Tâche	Temps	Exemples
Simple	30s - 2min	Composant UI, bouton, card
Moyen	2 - 10min	Formulaire, CRUD, dashboard
Complexe	10 - 30min	Auth system, chat, paiement
Très complexe	30 - 60min	Migration, refactor complet
Enterprise	1 - 3h	Microservices, multi-tenant

Facteurs d'influence:

Nombre de fichiers
Domaines (frontend+backend+DB = +temps)
Wave mode (+temps mais +qualité)
MCP servers (+temps mais +expertise)
Agents parallèles (divisent le temps)

Comparaison développement manuel:

Tâche: Système d'authentification complet

Manuel:        4-8 heures
WD Framework:  15-20 minutes

Gain: ~75% de temps 🚀

Accélérer l'exécution?

Réponse:

5 techniques d'accélération:

Mode Fast
```
/wd:implement Prototype --fast
```
Gain: 40-60% temps (compromis qualité)
Désactiver MCP si non nécessaire
```
/wd:implement --no-mcp
```
Gain: 20-30% temps
Agents parallèles
```
/wd:implement Multi-domain feature --agents
```
Gain: 40-70% temps (parallélisation)
Désactiver wave mode
```
/wd:implement --wave-mode off
```
Gain: 30-50% temps (moins de qualité)

Soyez précis (évitez l'analyse)

❌ "Améliorer l'app" (vague, analyse longue)
✅ "Optimiser la fonction calculateTotal" (précis, direct)

Combinaison rapide:

/wd:implement Quick prototype --fast --no-mcp --wave-mode off

⚠️ Attention: Vitesse = compromis sur qualité. Pour production, préférez la qualité!

Pourquoi c'est lent?

Réponse:

Diagnostic des causes:

1. Complexité élevée

# Vérifier la complexité
/wd:analyze complexity

# Solution: Décomposer
/wd:implement Feature partie 1
/wd:implement Feature partie 2

2. Trop de fichiers analysés

# Solution: Être spécifique
❌ /wd:improve Améliorer l'app (analyse tout)
✅ /wd:improve Améliorer src/components/Dashboard.tsx

3. Wave mode actif

# Si non nécessaire
/wd:implement --wave-mode off

4. Tous les MCP servers actifs

# Utiliser seulement ceux nécessaires
/wd:implement --c7  # Au lieu de --all-mcp

5. Ultrathink sur tâche simple

# Réservez pour tâches complexes
❌ /wd:implement Button --ultrathink
✅ /wd:implement Button

6. Ressources système

# Vérifier l'usage
/wd:analyze resources

Qualité

Garantir la qualité?

Réponse:

Le framework intègre 8 quality gates automatiques:

Les 8 Gates:

✅ 1. SYNTAX
   └─ Code compile sans erreur

✅ 2. TYPE SAFETY
   └─ TypeScript types corrects

✅ 3. LINTING
   └─ Style et best practices

✅ 4. SECURITY
   └─ Pas de vulnérabilités (OWASP Top 10)

✅ 5. TESTING
   └─ Couverture ≥80% (unit), ≥70% (integration)

✅ 6. PERFORMANCE
   └─ Budgets respectés (<100ms)

✅ 7. DOCUMENTATION
   └─ Documentation ≥80%

✅ 8. INTEGRATION
   └─ Compatible avec codebase existant

Processus:

Code généré
    ↓
Gate 1 → Pass? → Gate 2 → Pass? → ... → Gate 8
    ↓ Fail           ↓ Fail              ↓
  Auto-fix       Auto-fix            Rapport
    ↓               ↓                     ↓
  Re-check      Re-check              Utilisateur

Niveaux de qualité:

# Standard (8 gates)
/wd:implement

# Maximum (enterprise strategy)
/wd:implement --wave-strategy enterprise

# Relâché (prototyping)
/wd:implement --fast

Garantie: Tout code qui passe les 8 gates est production-ready!

Le framework peut-il faire des erreurs?

Réponse:

Oui, mais rarement.

Taux d'erreur:

Simple: <1%
Moyen: ~2-5%
Complexe: ~5-10%

Types d'erreurs possibles:

Mauvaise interprétation de la demande (ambiguïté)
Bug dans le code généré
Tests incomplets
Edge cases non couverts

Protection:

✅ 8 quality gates détectent 80-90% des erreurs
✅ Auto-fix corrige automatiquement
✅ Wave mode réduit erreurs de 30-50%
✅ Tests générés automatiquement

Best practices:

# 1. Soyez précis
❌ "Créer un formulaire"
✅ "Créer formulaire de contact avec nom, email, message et validation"

# 2. Utilisez wave mode pour critique
/wd:implement Banking feature --wave-mode force

# 3. Reviewez le code
# Toujours faire une review du code généré

# 4. Testez
/wd:test coverage

Si erreur détectée:

# Corrigez avec
/wd:troubleshoot Le problème spécifique

Corriger une erreur?

Réponse:

Approche en 3 étapes:

1. Identifier l'erreur

# Analyser le problème
/wd:analyze Le code problématique

# Ou expliquer
/wd:explain Pourquoi cette erreur se produit

2. Tenter auto-fix

# Le framework essaie de corriger
/wd:troubleshoot Description de l'erreur

3. Correction manuelle si nécessaire

# Demander amélioration spécifique
/wd:improve Corriger [problème spécifique]

Exemples concrets:

Erreur: Test qui échoue

# 1. Comprendre
/wd:explain Pourquoi le test échoue

# 2. Corriger
/wd:troubleshoot Test échoue avec erreur "..."

# 3. Re-tester
/wd:test

Erreur: Performance

# 1. Profiler
/wd:analyze performance

# 2. Optimiser
/wd:improve Optimiser --persona-performance

# 3. Benchmark
/wd:benchmark Compare

Erreur: Sécurité

# 1. Audit
/wd:analyze security

# 2. Corriger
/wd:improve Fix vulnerabilities --persona-security

# 3. Re-audit
/wd:analyze security

Troubleshooting

Erreur: "Complexity too high"

Problème:

Error: Task complexity (0.95) exceeds maximum (0.90).
Please break down into smaller tasks.

Cause: Tâche trop complexe pour être traitée en une fois.

Solutions:

Solution 1: Décomposer la tâche

# Au lieu de:
❌ /wd:implement Application e-commerce complète

# Faites:
✅ /wd:implement Backend API produits
✅ /wd:implement Frontend catalogue
✅ /wd:implement Système de paiement
✅ /wd:implement Gestion commandes

Solution 2: Utiliser agents

# Les agents gèrent mieux la complexité
/wd:implement Tâche complexe --agents --wave-mode force

Solution 3: Wave orchestration

# Les vagues décomposent automatiquement
/wd:implement Tâche complexe --wave-mode force --wave-strategy systematic

Erreur: "Resource limit exceeded"

Problème:

Error: Resource usage at 96% (CRITICAL zone).
Operation blocked to prevent system overload.

Cause: Tokens ou ressources système insuffisantes.

Solutions:

Solution 1: Mode Ultra-Compressed

/wd:implement Ma tâche --uc
# Économie: 30-50% tokens

Solution 2: Désactiver MCP servers

/wd:implement Ma tâche --no-mcp

Solution 3: Désactiver wave mode

/wd:implement Ma tâche --wave-mode off

Solution 4: Simplifier la tâche

# Réduire le scope
❌ /wd:implement Tout l'app
✅ /wd:implement Module spécifique

Solution 5: Augmenter les limites

# Dans .wd/config.json
{
  "resourceLimits": {
    "tokens": 200000,  # Augmenter si possible
    "maxConcurrency": 5
  }
}

Le résultat ne correspond pas

Problème: Le code généré n'est pas ce que vous attendiez.

Diagnostic:

1. Demande ambiguë?

# Vérifier la clarté
❌ "Créer un formulaire"
✅ "Créer formulaire de connexion avec email, password et bouton submit"

2. Mauvais persona activé?

# Forcer le bon persona
/wd:implement Ma tâche --persona-frontend  # Si c'est UI

3. Contexte manquant?

# Donner plus de contexte
/wd:implement Ajouter feature X dans le module Y avec contrainte Z

Solutions:

Améliorer la demande:

# Originale
❌ /wd:implement Liste de produits

# Améliorée
✅ /wd:implement Liste paginée de produits avec filtres (catégorie, prix, nom),
   tri (prix, date), et affichage en grille responsive

Itérer:

# Première tentative
/wd:implement Feature

# Si pas parfait, améliorer
/wd:improve Ajouter fonctionnalité X manquante

Recommencer avec plus de détails:

# Annuler
git restore .

# Recommencer avec précisions
/wd:implement [description détaillée]

Tests échouent après génération

Problème: Les tests générés échouent.

Diagnostic:

1. Vérifier les erreurs

npm test
# Lire les messages d'erreur

2. Analyser

/wd:explain Pourquoi les tests échouent

Solutions:

Solution 1: Auto-fix

/wd:troubleshoot Tests échouent avec erreur "[message d'erreur]"

Solution 2: Régénérer tests

/wd:test generate --agent wd-test-agent

Solution 3: Fix spécifique

# Corriger un test précis
/wd:improve Corriger le test src/components/Button.test.tsx

Solution 4: Vérifier dépendances

# Peut-être dépendances manquantes
npm install

Conflits Git après modification

Problème: Conflits de merge après modifications du framework.

Prévention:

Toujours commit avant:

git add .
git commit -m "Before WD Framework changes"

Résolution:

1. Voir les conflits

git status

2. Résoudre manuellement

# Éditer les fichiers en conflit
# Chercher les marqueurs:
# <<<<<<< HEAD
# =======
# >>>>>>> branch

3. Ou utiliser le framework

/wd:troubleshoot Résoudre les conflits Git dans [fichiers]

4. Ou restaurer

# Si trop de conflits, recommencer
git reset --hard HEAD

# Recommencer la modification
/wd:implement ...

💡 Astuces Pro

Astuce 1: Batch Processing

Au lieu de commandes séparées:

# 5 commandes = 5x overhead
/wd:implement Component A
/wd:implement Component B
/wd:implement Component C
/wd:implement Component D
/wd:implement Component E

Faites:

# 1 commande, plus efficace
/wd:implement Components A, B, C, D, E pour le dashboard

Astuce 2: Contexte Cumulatif

Le framework garde le contexte:

# Conversation
You: /wd:implement User authentication system
Framework: [génère auth system]

You: Maintenant ajoute 2FA
Framework: [ajoute 2FA au système existant, comprend le contexte]

You: Et rate limiting sur login
Framework: [ajoute rate limiting, comprend toujours le contexte]

Astuce 3: Itération Progressive

Pour projets complexes:

# Étape 1: MVP
/wd:implement Auth system MVP (login + logout)

# Étape 2: Améliorer
/wd:improve Ajouter register et forgot password

# Étape 3: Sécuriser
/wd:improve Ajouter 2FA et rate limiting --persona-security

# Étape 4: Optimiser
/wd:improve Optimiser performance --persona-performance

Astuce 4: Combiner Flags Intelligemment

# Prototype rapide
--fast --no-mcp --wave-mode off

# Production standard
# (aucun flag, laissez auto)

# Production critique
--wave-mode force --wave-strategy enterprise --agents --all-mcp --ultrathink

# Économique mais qualité
--uc --wave-mode auto

Astuce 5: Utiliser /wd:explain pour Apprendre

# Comprendre le code généré
/wd:explain Comment fonctionne le code que tu as généré

# Apprendre un pattern
/wd:explain Le pattern Repository utilisé dans ce code

# Comprendre une décision
/wd:explain Pourquoi tu as utilisé bcrypt avec cost 12

📞 Besoin d'Aide?

Ressources

Documentation:
Support:
- GitHub Issues: Créer un issue
- Discord: [Communauté WD Framework]
- Email: [email protected]

Template pour Signaler un Bug

**Description**
Brève description du problème

**Commande utilisée**
/wd:implement ...

**Flags**
--flag1 --flag2

**Comportement attendu**
Ce qui devrait se passer

**Comportement actuel**
Ce qui se passe réellement

**Logs/Erreurs**
[Copier les erreurs ici]

**Contexte**
- OS: macOS/Windows/Linux
- Claude Code version: X.X.X
- WD Framework version: X.X.X
- Node version: X.X.X

🎯 Checklist de Résolution

Avant de demander de l'aide, vérifiez:

J'ai lu le Guide de Démarrage Rapide
J'ai cherché dans cette FAQ
J'ai vérifié les Exemples Pratiques
J'ai essayé de décomposer la tâche
J'ai vérifié que ma demande est claire
J'ai vérifié les logs d'erreur
J'ai essayé /wd:troubleshoot
J'ai commit mes changements avant d'essayer

📅 Dernière mise à jour: WD Framework v2.0 ❓ Questions? Ouvrez un issue sur GitHub 💬 Feedback? Nous sommes à l'écoute!

FAQ ET TROUBLESHOOTING

❓ WD Framework - FAQ & Troubleshooting

📖 Table des Matières

Questions Générales

Utilisation

Personas & Agents

Orchestration

Performance

Qualité

Troubleshooting

Questions Générales

Qu'est-ce que le WD Framework?

Comment ça fonctionne?

Est-ce gratuit?

Différence avec Claude Code standard?

Utilisation

Quelle commande utiliser?

Améliorer la qualité des résultats?

Quand utiliser --ultrathink?

Économiser des tokens?

Annuler une opération?

Personas & Agents

C'est quoi un persona?

Différence persona vs agent?

Comment choisir un persona?

Créer mon propre persona?

Orchestration

C'est quoi les vagues (waves)?

Quand utiliser wave mode?

Différence entre les stratégies?

Performance

Combien de temps ça prend?

Accélérer l'exécution?

Pourquoi c'est lent?

Qualité

Garantir la qualité?

Le framework peut-il faire des erreurs?

Corriger une erreur?

Troubleshooting

Erreur: "Complexity too high"

Erreur: "Resource limit exceeded"

Le résultat ne correspond pas

Tests échouent après génération

Conflits Git après modification

💡 Astuces Pro

Astuce 1: Batch Processing

Astuce 2: Contexte Cumulatif

Astuce 3: Itération Progressive

Astuce 4: Combiner Flags Intelligemment

Astuce 5: Utiliser /wd:explain pour Apprendre

📞 Besoin d'Aide?

Ressources

Template pour Signaler un Bug

🎯 Checklist de Résolution