sdd-help

/sdd-help — Aide contextuelle "what's next"

Nouveau v7.0.0+ (emprunt bmad-help) : guidance contextuelle orientée action — pas un diagnostic brut comme /sdd-status, mais une recommandation de la prochaine commande logique selon l'état détecté du projet.

Lecture seule, aucune écriture, aucune invocation d'agent. Coût : ~0 token (délégation à sdd_state.py + query_console_db.py).

Usage :

• /sdd-help — guidance globale projet (où on en est + quoi faire)
• /sdd-help {n} — guidance focalisée sur FEAT {n}
• /sdd-help "comment X ?" — réponse FAQ (matching mots-clés)

Différence avec /sdd-status : /sdd-status rend un tree ASCII de l'état complet (snapshot). /sdd-help fait la même introspection mais retourne 1-3 lignes de guidance actionnable : la commande suivante à lancer + son but. Pour les utilisateurs qui ne connaissent pas les 13 commandes par cœur.

---

STEP 1 — Détection du mode

Argument	Mode
absent	global : scanner toutes les FEATs, identifier le plus gros gap
entier ≥ 1	focused : focus sur FEAT {n}, suggérer prochaine étape
commence par " ou ' ou contient un ?	FAQ : matcher mots-clés contre §FAQ ci-dessous

Si argument numérique mais aucune FEAT {n}-*.md trouvée →

Aucune FEAT {n} dans workspace/feats/.
Pour la créer : /feat-generate {NomDeLaFeature}

---

STEP 2 — Collecte d'état déterministe (0 LLM)

# État global (FEATs, US, mockups, ARCH, DB, CLAUDE.md projets)
python .sdd/python/sdd_scripts/sdd_state.py status [--feat-number {n}] --json

# Métriques QA (si FEAT donnée)
python .sdd/python/sdd_scripts/query_console_db.py feat-stats --feat {n} 2>/dev/null

Latence cumulée ~100 ms. Échec script → fallback minimal : retourner la commande /sdd-status et inviter Tech Lead à diagnostiquer.

---

STEP 3 — Décision (arbre)

3.A — Mode global (aucune FEAT en argument)

Évaluer dans l'ordre, premier match gagne :

Condition détectée	Recommandation (1L)
0 FEAT dans workspace/feats/	/feat-generate <Nom> — démarrer la 1ʳᵉ FEAT (3-6 questions, ~2 min)
≥ 1 FEAT, 0 US générée pour ≥ 1 FEAT	/us-generate {n} — découper la FEAT en User Stories testables
≥ 1 FEAT avec US, aucun rapport readiness workspace/.sys/.validation/{n}-readiness.md	/feat-validate {n} — vérifier la maturité avant de coder (gate GO/NO-GO)
≥ 1 FEAT validée, aucun projet sous workspace/src/	/sdd-full {n} — pipeline A→Z (arch + back + API gate + front + QA + review)
Projet bootstrappé mais ≥ 1 FEAT avec US Status: Ready sans code	/dev-run {n} — matérialiser le code (back → API gate → front)
Code généré, QA non exécutée (coverage.json absent)	/qa-generate {n} — générer tests + coverage + quality scan
QA OK, pas de /sdd-review récent (> 24h ou absent)	/sdd-review {n} — audit consolidé style Sonar
Toutes FEATs en 🟢 ✓	/sdd-status — voir le récap, ou créer une nouvelle FEAT avec /feat-generate