|
@@ -558,8 +558,6 @@ WHAT TO VERIFY NEXT:
|
|
|
DO NOT TOUCH:
|
|
DO NOT TOUCH:
|
|
|
src/store/cartStore.ts dans son ensemble — corriger seulement la ligne 47
|
|
src/store/cartStore.ts dans son ensemble — corriger seulement la ligne 47
|
|
|
```
|
|
```
|
|
|
-
|
|
|
|
|
-
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
### Exemple 6 — CLI Rust from scratch (workflow minimaliste)
|
|
### Exemple 6 — CLI Rust from scratch (workflow minimaliste)
|
|
@@ -664,11 +662,7 @@ Simple à valider. L'architecture proposée est plate, pas de surprise.
|
|
|
|
|
|
|
|
**`/analyze` avant `/refactor` :** toujours. Le refactorer attend le rapport d'analyse avant de toucher au code. Le passer en bypass donne de moins bons résultats.
|
|
**`/analyze` avant `/refactor` :** toujours. Le refactorer attend le rapport d'analyse avant de toucher au code. Le passer en bypass donne de moins bons résultats.
|
|
|
|
|
|
|
|
-**`/readme` régulièrement :** après chaque milestone. Le mode AUDIT compare le README à l'état réel du code et liste les divergences — évite la documentation périmée.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
|
|
+**`/doc` régulièrement :** après chaque milestone. Le mode AUDIT compare la documentation à l'état réel du code et liste les divergences — évite la documentation périmée.
|
|
|
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
@@ -775,417 +769,6 @@ TESTS: ✅ 8 tests passent (créés avant refactoring)
|
|
|
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
-## Cas de figure — corrections v2.2.0 validées
|
|
|
|
|
-
|
|
|
|
|
-Ces exemples valident les bugs corrigés dans la version 2.2.0.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas A — Onboarding d'un monorepo Next.js + FastAPI
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** repo avec `apps/web/` (Next.js 14) et `apps/api/` (FastAPI). Pas de `CLAUDE.md`. La racine n'a qu'un `package.json` de workspace vide.
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.2.0 :** `/onboard` lisait le `package.json` racine (workspaces uniquement), ne trouvait pas de stack claire, produisait un `CLAUDE.md` incomplet ou demandait trop de questions.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.2.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-/onboard
|
|
|
|
|
-
|
|
|
|
|
-→ PHASE 1: apps/, pnpm-workspace.yaml détectés
|
|
|
|
|
-
|
|
|
|
|
-MONOREPO DETECTED
|
|
|
|
|
-Sub-packages: apps/web/, apps/api/
|
|
|
|
|
-Options:
|
|
|
|
|
- A) Workspace entier — un CLAUDE.md à la racine
|
|
|
|
|
- B) apps/web seulement
|
|
|
|
|
- C) Chaque package séparément
|
|
|
|
|
-
|
|
|
|
|
-[User: A]
|
|
|
|
|
-
|
|
|
|
|
-→ Lit apps/web/package.json → Next.js 14, TypeScript, Tailwind
|
|
|
|
|
-→ Lit apps/api/pyproject.toml → FastAPI, SQLAlchemy, alembic
|
|
|
|
|
-→ Lit Makefile racine → make dev-web, make dev-api, make test
|
|
|
|
|
-
|
|
|
|
|
-→ CLAUDE.md généré:
|
|
|
|
|
- Stack: Next.js 14 (apps/web/) + FastAPI (apps/api/) + PostgreSQL
|
|
|
|
|
- Build: make dev-web | make dev-api | docker compose up --build
|
|
|
|
|
- Structure: monorepo, 2 apps indépendantes, DB partagée
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas B — ship-feature : subagent en échec
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** feature notifications email, STEP 4, tâche 3 (worker retry) échoue.
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.2.0 :** arrêt abrupt. L'utilisateur devait diagnostiquer lui-même, relancer manuellement.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.2.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-STEP 4 — Tâche 3 échoue:
|
|
|
|
|
- pytest FAILED test_retry_on_failure — AssertionError: worker ne retente pas
|
|
|
|
|
-
|
|
|
|
|
-→ STEP 4b déclenché automatiquement
|
|
|
|
|
-
|
|
|
|
|
-DEBUG ANALYSIS: Worker ne retente pas après timeout SMTP
|
|
|
|
|
-ROOT CAUSE:
|
|
|
|
|
- 1. [HIGH] Mock déclenche ConnectionRefusedError ≠ SMTPException — le retry handler ne s'active pas
|
|
|
|
|
- 2. [MED] max_retries non configuré dans le worker (valeur par défaut = 0)
|
|
|
|
|
-
|
|
|
|
|
-SHIP FEATURE — ERROR IN STEP 4
|
|
|
|
|
-OPTIONS:
|
|
|
|
|
- A) Corriger le mock (hypothesis 1)
|
|
|
|
|
- B) Passer cette tâche
|
|
|
|
|
- C) Abort
|
|
|
|
|
-
|
|
|
|
|
-[User: A] → fix ciblé → re-run tâche 3 → passe ✅ → suite de la feature
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas C — Projet mobile React Native : signal correct
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** `/init-project "App mobile KartApp React Native Expo iOS Android"`.
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.2.0 :** signal `frontend` uniquement → `gstack` potentiellement recommandé (aberrant sur mobile).
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.2.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-SIGNALS: mobile (React Native + Expo détectés)
|
|
|
|
|
-
|
|
|
|
|
-RECOMMENDATIONS:
|
|
|
|
|
- ⚡ ENABLE : frontend-design — composants React Native (~200t)
|
|
|
|
|
- ⚠️ DISABLE : gstack — mobile, pas de browser QA ni deploy web
|
|
|
|
|
- ℹ️ OPTIONAL: ui-ux-pro-max — uniquement si design system complexe
|
|
|
|
|
- ℹ️ NOTE : Docker N/A pour les apps mobiles
|
|
|
|
|
-
|
|
|
|
|
-BLOCKING: none
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas D — STEP 13 avec GSD v2 non installé
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** `/init-project` multi-session atteint STEP 13. `gsd` absent du PATH.
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.2.0 :** `gsd init` → "command not found" → erreur opaque.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.2.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-STEP 13 — GSD v2 INIT
|
|
|
|
|
-→ Vérification: command -v gsd → NOT FOUND
|
|
|
|
|
-
|
|
|
|
|
-⚠️ GSD v2 not installed.
|
|
|
|
|
- Run: npm install -g gsd-pi
|
|
|
|
|
- Then: /onboard add gsd (pour générer ROADMAP.md)
|
|
|
|
|
-
|
|
|
|
|
-→ STEP 13 skippé proprement
|
|
|
|
|
-→ Projet initialisé correctement ✅
|
|
|
|
|
-→ GSD v2 peut être ajouté plus tard
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas E — CLI Rust : workflow minimaliste (0 plugin inutile)
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** `/init-project "CLI Rust jsonconv, pas de réseau, pas de frontend"`.
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-/plugin-check "CLI Rust convertisseur JSON/CSV/TOML"
|
|
|
|
|
-
|
|
|
|
|
-SIGNALS: simple, CLI pur
|
|
|
|
|
-COST: ~800t
|
|
|
|
|
-
|
|
|
|
|
-RECOMMENDATIONS:
|
|
|
|
|
- ✅ KEEP : superpowers
|
|
|
|
|
- ⚠️ DISABLE: frontend-design, ui-ux-pro-max, gstack, context7, ruflo
|
|
|
|
|
-BLOCKING: none → "proceed"
|
|
|
|
|
-
|
|
|
|
|
-→ Scaffolder: cargo check comme verify (pas cargo build)
|
|
|
|
|
-→ Docker: N/A (CLI pur)
|
|
|
|
|
-→ Pipeline complet en ~800t passif, zéro bruit
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Point clé : **`/plugin-check` est utile même pour confirmer qu'on n'a rien à activer.** Évite de polluer le contexte avec 3000t de plugins inutiles sur un projet simple.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-## Cas de figure — corrections v2.3.0 validées
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas F — `/ship-feature` sans CLAUDE.md (nouveau repo cloné)
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** développeur clone un repo existant, lance directement `/ship-feature` sans avoir run `/onboard`.
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.3.0 :** le brainstorm (STEP 1) démarrait sans contexte projet → questions génériques, architecture inadaptée au projet réel.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.3.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-/ship-feature "Ajouter authentification OAuth Google"
|
|
|
|
|
-
|
|
|
|
|
-→ STEP 0 : plugin check OK
|
|
|
|
|
-→ STEP 0b : ls CLAUDE.md .claude/CLAUDE.md → rien trouvé
|
|
|
|
|
-
|
|
|
|
|
-⚠️ No CLAUDE.md found in this directory.
|
|
|
|
|
- This project has not been onboarded into claude-config.
|
|
|
|
|
- Run `/onboard` first, then re-run `/ship-feature`.
|
|
|
|
|
- STOP.
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-L'utilisateur fait `/onboard`, obtient son CLAUDE.md, relance `/ship-feature` avec le bon contexte.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas G — Onboarding monorepo turborepo (Option C séquentielle)
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** repo avec `apps/web/`, `apps/api/`, `packages/ui/`, `turbo.json`, `pnpm-workspace.yaml`.
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.3.0 :** Option C non implémentée — comportement indéfini.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.3.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-/onboard
|
|
|
|
|
-
|
|
|
|
|
-MONOREPO DETECTED (turbo.json + pnpm-workspace.yaml)
|
|
|
|
|
-Sub-packages: apps/web/, apps/api/, packages/ui/
|
|
|
|
|
-[User: C]
|
|
|
|
|
-
|
|
|
|
|
-── Package 1/3: apps/web ──
|
|
|
|
|
- Stack: Next.js 14 / TypeScript
|
|
|
|
|
- Genere: apps/web/CLAUDE.md + settings + .claudeignore
|
|
|
|
|
- OK
|
|
|
|
|
-
|
|
|
|
|
-── Package 2/3: apps/api ──
|
|
|
|
|
- Stack: Express / Prisma / PostgreSQL
|
|
|
|
|
- Genere: apps/api/CLAUDE.md + settings + .claudeignore
|
|
|
|
|
- OK
|
|
|
|
|
-
|
|
|
|
|
-── Package 3/3: packages/ui ──
|
|
|
|
|
- Stack: React + Storybook + Tailwind
|
|
|
|
|
- Genere: packages/ui/CLAUDE.md + settings + .claudeignore
|
|
|
|
|
- OK
|
|
|
|
|
-
|
|
|
|
|
-Resume: 3 packages onboardes
|
|
|
|
|
- apps/web | Next.js 14 | OK
|
|
|
|
|
- apps/api | Express/Prisma| OK
|
|
|
|
|
- packages/ui | React/Storybook| OK
|
|
|
|
|
-
|
|
|
|
|
-"Generate root-level ROADMAP.md? (yes/skip)"
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Chaque package a son propre CLAUDE.md. Pas de CLAUDE.md racine (Option C).
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas H — plugin-advisor : signal `monorepo` evite gstack inutile
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** monorepo Next.js (apps/web/) + FastAPI (apps/api/). Avant : signal `frontend` + `deploy` → gstack recommandé pour tout le repo.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.3.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-SIGNALS: monorepo, frontend(apps/web/), fast-libs(Next.js), deploy(apps/api/)
|
|
|
|
|
-
|
|
|
|
|
-RECOMMENDATIONS:
|
|
|
|
|
- OK KEEP : superpowers
|
|
|
|
|
- ENABLE : frontend-design — apps/web/ uniquement (~200t)
|
|
|
|
|
- WARN : context7 — Next.js detecte dans apps/web/
|
|
|
|
|
- DISABLE : gstack — apps/api/ n'a pas de browser-qa
|
|
|
|
|
- (NOTE: gstack aurait ete recommande si browser-qa present)
|
|
|
|
|
- DISABLE : ui-ux-pro-max — pas de design-system signal
|
|
|
|
|
-
|
|
|
|
|
-Cout total: ~1200t (au lieu de ~4400t avec gstack)
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas I — doctor.sh detecte templates/ manquant (installation pre-v2.0.0)
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** installation ancienne (avant v2.0.0), `link.sh` n'avait pas de templates dans la boucle.
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.3.0 :** `/init-project` echouait silencieusement en STEP 5 (scaffolder ne trouvait pas `~/.claude/templates/project-CLAUDE.md`).
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.3.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-bash doctor.sh
|
|
|
|
|
-
|
|
|
|
|
-── Symlinks ──
|
|
|
|
|
- OK ~/.claude/CLAUDE.md
|
|
|
|
|
- OK ~/.claude/settings.json
|
|
|
|
|
- OK ~/.claude/agents
|
|
|
|
|
- OK ~/.claude/skills
|
|
|
|
|
- MISSING: ~/.claude/templates ← nouveau check
|
|
|
|
|
- OK ~/.claude/hooks/session-start.sh
|
|
|
|
|
-
|
|
|
|
|
-Fix: cd /path/to/claude-config && bash link.sh
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-L'utilisateur voit exactement ce qui manque et la commande pour corriger.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas J — session-start : box ne deborde pas avec 5 plugins actifs
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.3.0 :** avec `gstack frontend-design ui-ux-pro-max context7 ruflo` tous actifs, la ligne `ON` depassait la largeur de la box.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.3.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-┌─ Claude Code config ──────────────────────────────────┐
|
|
|
|
|
-│ ✅ ON : security-guidance rtk superpowers │
|
|
|
|
|
-│ 🟢 ON : gstack frontend-design ui-ux-pro-ma... │ <- tronque a 37+...
|
|
|
|
|
-│ ⚫ OFF : none │
|
|
|
|
|
-│ 💰 ~5350t passif (48% budget) │
|
|
|
|
|
-│ 📦 v2.3.0 │
|
|
|
|
|
-└───────────────────────────────────────────────────────┘
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-La box reste alignee. L'utilisateur voit qu'il y a plus de plugins (les `...` indiquent la troncature) et peut faire `/health` pour la liste complete.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-## Cas de figure — corrections v2.4.0 validées
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas K — `/init-project` sur un projet avec CLAUDE.md existant
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** projet FastAPI avec un `CLAUDE.md` minimal (stack documenté, features absentes). L'utilisateur veut ajouter un module de facturation.
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.4.0 :** STEP 1 posait toutes les questions (stack, purpose, features, conventions) même si le stack était déjà documenté.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.4.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-/init-project "Ajouter un module de facturation au projet"
|
|
|
|
|
-
|
|
|
|
|
-STEP 1 — ls CLAUDE.md → FOUND
|
|
|
|
|
-📄 Existing CLAUDE.md found — using as context.
|
|
|
|
|
-
|
|
|
|
|
-Questions posées (manquantes seulement):
|
|
|
|
|
- → Features v1 du module facturation ?
|
|
|
|
|
- → Stratégie de tests ?
|
|
|
|
|
- → Conventions spécifiques ?
|
|
|
|
|
-
|
|
|
|
|
-Questions SKIP (déjà dans CLAUDE.md):
|
|
|
|
|
- → Stack (Python 3.12 / FastAPI / PostgreSQL) ✓
|
|
|
|
|
- → Architecture ✓
|
|
|
|
|
-```
|
|
|
|
|
-3 questions au lieu de 6. Gain de temps significatif sur les projets déjà documentés.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas L — `/status` en début de session (projet multi-semaines)
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** projet CardForge repris après 3 jours. GSD v2 initialisé, milestone 2 en cours.
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-/status
|
|
|
|
|
-
|
|
|
|
|
-PROJECT STATUS
|
|
|
|
|
-==============
|
|
|
|
|
-
|
|
|
|
|
-CONFIG
|
|
|
|
|
- Version : v2.4.0
|
|
|
|
|
- Plugins ON: superpowers, frontend-design, context7 (~1200t)
|
|
|
|
|
- GSD v2 : installed (2.64.0)
|
|
|
|
|
-
|
|
|
|
|
-PROJECT
|
|
|
|
|
- CLAUDE.md : found
|
|
|
|
|
- Stack : React 18 + FastAPI + PostgreSQL + Docker
|
|
|
|
|
- Branch : feature/stripe-integration
|
|
|
|
|
- Uncommitted: 3 files
|
|
|
|
|
-
|
|
|
|
|
-RECENT COMMITS (last 5):
|
|
|
|
|
- a1b2c3d feat: add card collection schema
|
|
|
|
|
- e4f5g6h fix: jwt refresh token expiry
|
|
|
|
|
- ...
|
|
|
|
|
-
|
|
|
|
|
-GSD v2
|
|
|
|
|
- Status : initialized
|
|
|
|
|
- Milestone : Milestone 2 — Boutique in-app
|
|
|
|
|
- Progress : 2/5 slices done
|
|
|
|
|
-
|
|
|
|
|
-QUICK ACTIONS
|
|
|
|
|
- /ship-feature "..." — next feature
|
|
|
|
|
- /health — full diagnostic
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Vue complète en une commande. Utile après un break pour se réorienter avant de taper `/gsd auto`.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas M — plugin-advisor depuis un sous-package de monorepo
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** l'utilisateur est dans `apps/web/` et lance `/plugin-check`. Le monorepo a `turbo.json` et `pnpm-workspace.yaml` à la racine (`../`).
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.4.0 :** pas de détection monorepo → plugins recommandés comme pour un projet standalone Next.js.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.4.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-/plugin-check "Next.js frontend" (depuis apps/web/)
|
|
|
|
|
-
|
|
|
|
|
-PHASE 1 — upstream detection:
|
|
|
|
|
- ls ../turbo.json → FOUND
|
|
|
|
|
- ls ../pnpm-workspace.yaml → FOUND
|
|
|
|
|
-
|
|
|
|
|
-SIGNALS: monorepo (upstream), frontend, fast-libs(Next.js)
|
|
|
|
|
-NOTE: dans apps/web/ d'un monorepo (détecté via parent dir)
|
|
|
|
|
-
|
|
|
|
|
-RECOMMENDATIONS:
|
|
|
|
|
- ENABLE: frontend-design — apps/web/ uniquement
|
|
|
|
|
- WARN: context7 — Next.js détecté
|
|
|
|
|
- DISABLE: gstack — pas de browser-qa dans ce package
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-La recommandation est correcte même sans être à la racine du monorepo.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas N — doctor.sh avec compteur de symlinks
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** installation avant v2.0.0 — `templates/` n'est pas symlinké.
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-bash doctor.sh
|
|
|
|
|
-
|
|
|
|
|
-── Symlinks ──
|
|
|
|
|
- ✓ ~/.claude/CLAUDE.md
|
|
|
|
|
- ✓ ~/.claude/settings.json
|
|
|
|
|
- ✓ ~/.claude/agents
|
|
|
|
|
- ✓ ~/.claude/skills
|
|
|
|
|
- ✗ ~/.claude/templates — MISSING
|
|
|
|
|
- ✓ ~/.claude/hooks/session-start.sh
|
|
|
|
|
- → Symlinks: 5/6 OK
|
|
|
|
|
-
|
|
|
|
|
-Fix: cd /path/to/claude-config && bash link.sh
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Le compteur `5/6 OK` indique exactement le problème sans lire toutes les lignes.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas O — session-start avec 5 toggles actifs
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.4.0 :** avec gstack + frontend-design + ui-ux-pro-max + context7 + ruflo actifs, la ligne débordait la box.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.4.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-┌─ Claude Code config ──────────────────────────────────┐
|
|
|
|
|
-│ ✅ ON : security-guidance rtk superpowers │
|
|
|
|
|
-│ 🟢 ON : gstack frontend-design +3 more │
|
|
|
|
|
-│ ⚫ OFF : none │
|
|
|
|
|
-│ 💰 ~5350t passif (48% budget) │
|
|
|
|
|
-│ 📦 v2.4.0 │
|
|
|
|
|
-│ 💡 /plugin-check before starting a new project │
|
|
|
|
|
-│ 🩺 /health to run full diagnostic │
|
|
|
|
|
-└───────────────────────────────────────────────────────┘
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-`+3 more` indique qu'il y a 3 plugins actifs supplémentaires. `/health` donne la liste complète.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
### Exemple 8 — Reprise d'une session interrompue avec GSD v2
|
|
### Exemple 8 — Reprise d'une session interrompue avec GSD v2
|
|
|
|
|
|
|
|
**Contexte :** projet CardForge (React + FastAPI), milestone 2 "Boutique Stripe" en cours. Travail interrompu 4 jours plus tôt. GSD v2 initialisé, 3/7 slices terminées.
|
|
**Contexte :** projet CardForge (React + FastAPI), milestone 2 "Boutique Stripe" en cours. Travail interrompu 4 jours plus tôt. GSD v2 initialisé, 3/7 slices terminées.
|
|
@@ -1284,194 +867,58 @@ GSD v2 met à jour le plan dans `.gsd/ROADMAP.md` sans perdre le travail déjà
|
|
|
- **GSD v2 `step mode`** est préférable à `auto` après une longue pause — permet de vérifier que les décisions sont toujours valides.
|
|
- **GSD v2 `step mode`** est préférable à `auto` après une longue pause — permet de vérifier que les décisions sont toujours valides.
|
|
|
- **`.gsd/ROADMAP.md`** est la source de vérité du progress — parsé par `/status` et par GSD lui-même.
|
|
- **`.gsd/ROADMAP.md`** est la source de vérité du progress — parsé par `/status` et par GSD lui-même.
|
|
|
- **`/gsd discuss`** permet de modifier l'architecture en cours de route sans recommencer depuis zéro.
|
|
- **`/gsd discuss`** permet de modifier l'architecture en cours de route sans recommencer depuis zéro.
|
|
|
-
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
-## Cas de figure — corrections v2.5.0 validées
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas P — `/init-project` détecte `.claude/CLAUDE.md`
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** projet Node.js/Express avec CLAUDE.md dans `.claude/` (pas à la racine).
|
|
|
|
|
|
|
+### Exemple 9 — Firmware C/C++ embarqué (workflow sans superpowers)
|
|
|
|
|
|
|
|
-**Avant v2.5.0 :** `ls CLAUDE.md` ne trouvait rien → 6 questions pour redécouvrir le stack.
|
|
|
|
|
|
|
+**Contexte :** firmware pour microcontrôleur STM32 (C, bare-metal). Pas de réseau, pas de frontend, pas de Docker. L'outillage standard de superpowers (brainstorming Socratique, subagent pipeline) est surdimensionné pour ce contexte.
|
|
|
|
|
|
|
|
-**Avec v2.5.0 :**
|
|
|
|
|
|
|
+**Setup plugins :**
|
|
|
```
|
|
```
|
|
|
-/init-project "Ajouter notifications push"
|
|
|
|
|
-
|
|
|
|
|
-STEP 1: ls CLAUDE.md .claude/CLAUDE.md → .claude/CLAUDE.md FOUND
|
|
|
|
|
-📄 Existing CLAUDE.md found — using as context.
|
|
|
|
|
|
|
+/plugin-check "Firmware C STM32, bare-metal, pas de réseau, pas de frontend, pas de Docker"
|
|
|
|
|
|
|
|
-Questions posées (manquantes seulement):
|
|
|
|
|
- → Service push ? (Firebase/OneSignal/APNs ?)
|
|
|
|
|
- → Types ? (in-app/email/mobile ?)
|
|
|
|
|
|
|
+SIGNALS: simple, CLI/embedded
|
|
|
|
|
+COST: ~800t (superpowers seul)
|
|
|
|
|
|
|
|
-Questions SKIP (déjà dans .claude/CLAUDE.md):
|
|
|
|
|
- → Stack (Node.js 20 / Express / MongoDB) ✓
|
|
|
|
|
- → Purpose ✓
|
|
|
|
|
|
|
+RECOMMENDATIONS:
|
|
|
|
|
+ OK KEEP : superpowers (peut être utile pour brainstorm initial)
|
|
|
|
|
+ DISABLE : frontend-design, ui-ux-pro-max, gstack, context7, ruflo
|
|
|
|
|
+ NOTE : Pour un firmware vraiment simple (hotfix, modification ciblée),
|
|
|
|
|
+ même superpowers peut être désactivé → ~0t passif
|
|
|
```
|
|
```
|
|
|
-2 questions au lieu de 6.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas Q — `/status` avec GSD v2 et ROADMAP.md présent
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** projet CardForge avec `.gsd/ROADMAP.md` contenant des checkboxes GSD.
|
|
|
|
|
|
|
|
|
|
-**Avant v2.5.0 :** `cat .gsd/STATUS.md` → fichier inexistant → `"no STATUS.md"`.
|
|
|
|
|
|
|
+**Workflow minimaliste — modification d'un driver existant :**
|
|
|
|
|
|
|
|
-**Avec v2.5.0 :**
|
|
|
|
|
```
|
|
```
|
|
|
-/status
|
|
|
|
|
|
|
+# Pas de /init-project, pas de GSD, pas de superpowers
|
|
|
|
|
|
|
|
-PHASE 3 — parse ROADMAP.md:
|
|
|
|
|
- - [x] Slice 1 — Schema DB ✓
|
|
|
|
|
- - [x] Slice 2 — Auth JWT ✓
|
|
|
|
|
- - [x] Slice 3 — Collection cards ✓
|
|
|
|
|
- - [ ] Slice 4 — Boutique Stripe (en cours)
|
|
|
|
|
- - [ ] Slice 5 — PvP
|
|
|
|
|
- ...
|
|
|
|
|
|
|
+# 1. Comprendre avant de modifier
|
|
|
|
|
+/analyze src/drivers/uart.c
|
|
|
|
|
|
|
|
-GSD v2
|
|
|
|
|
- Status : initialized
|
|
|
|
|
- Milestone : Milestone 2 — Boutique in-app
|
|
|
|
|
- Progress : 3/7 slices done (43%)
|
|
|
|
|
|
|
+OUTPUT:
|
|
|
|
|
+ ANALYSIS: src/drivers/uart.c
|
|
|
|
|
+ CONTEXT: Driver UART pour STM32F4, DMA en mode circulaire
|
|
|
|
|
+ KEY COMPONENTS:
|
|
|
|
|
+ uart_init(): 45 lignes — config registres + DMA
|
|
|
|
|
+ uart_send(): 12 lignes — écriture dans ring buffer
|
|
|
|
|
+ UART_IRQHandler(): 28 lignes — ISR, gère overrun
|
|
|
|
|
+ RISKS:
|
|
|
|
|
+ - uart_init() dépasse 25 lignes → split candidat
|
|
|
|
|
+ - Accès non-atomique à ring_buffer_head dans ISR — probability: high
|
|
|
|
|
+ OPEN QUESTIONS:
|
|
|
|
|
+ - Quid si DMA transfer pas terminé avant appel uart_send() ?
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
----
|
|
|
|
|
|
|
+**Modification chirurgicale :**
|
|
|
|
|
+```
|
|
|
|
|
+/ship-feature "Corriger l'accès non-atomique au ring_buffer_head dans l'ISR"
|
|
|
|
|
|
|
|
-### Cas R — `/status` avec `.gsd/` vide (pas de ROADMAP.md)
|
|
|
|
|
|
|
+STEP 0b — CLAUDE.md found
|
|
|
|
|
+STEP 0 — plugin check: superpowers OK (ou désactivé si YOLO mode)
|
|
|
|
|
|
|
|
-**Contexte :** `gsd init` fait mais `/gsd discuss` pas encore lancé.
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-/status
|
|
|
|
|
-
|
|
|
|
|
-GSD v2
|
|
|
|
|
- Status : initialized
|
|
|
|
|
- Milestone : N/A
|
|
|
|
|
- Progress : N/A
|
|
|
|
|
-
|
|
|
|
|
- GSD v2 initialized — no ROADMAP.md yet.
|
|
|
|
|
- Run /gsd init or /gsd discuss to create one.
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Message actionnable au lieu d'une erreur silencieuse.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas S — `doctor.sh` détecte `status-reporter.md` manquant
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** installation v2.3.0 ou antérieure — `status-reporter.md` n'existait pas.
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-bash doctor.sh
|
|
|
|
|
-
|
|
|
|
|
-── Consistency ──
|
|
|
|
|
- ✓ All skills have disable-model-invocation
|
|
|
|
|
- ⚠ Missing agents: status-reporter.md — run: bash link.sh
|
|
|
|
|
- ✓ No CRLF line endings detected
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Sans ce check : `/status` chargerait un agent inexistant → erreur cryptique.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas T — session-start avec 6 plugins actifs (tous affichés)
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.5.0 :** `gstack frontend-design +4 more` — 4 plugins masqués.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.5.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-┌─ Claude Code config ──────────────────────────────────┐
|
|
|
|
|
-│ ✅ ON : security-guidance rtk superpowers │
|
|
|
|
|
-│ 🟢 ON : gstack frontend-design ui-ux-pro-max context7│
|
|
|
|
|
-│ + ruflo plugin-dev │
|
|
|
|
|
-│ ⚫ OFF : none │
|
|
|
|
|
-│ 💰 ~5750t passif (52% budget) │
|
|
|
|
|
-│ 📦 v2.5.0 │
|
|
|
|
|
-└───────────────────────────────────────────────────────┘
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Tous les noms visibles, box alignée.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas U — onboarder crée `.gitignore` pour protéger `settings.local.json`
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** monorepo, Option B (apps/api/), aucun `.gitignore` dans le package.
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-/onboard B apps/api
|
|
|
|
|
-
|
|
|
|
|
-PHASE 5b — .gitignore check:
|
|
|
|
|
- ls .gitignore → absent
|
|
|
|
|
-
|
|
|
|
|
- Créé: apps/api/.gitignore
|
|
|
|
|
- # claude-config — personal settings (never commit)
|
|
|
|
|
- .claude/settings.local.json
|
|
|
|
|
-
|
|
|
|
|
-📝 Created .gitignore with .claude/settings.local.json entry
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Sans ce check : `settings.local.json` risquait d'être commité avec les clés API et credentials.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Exemple 9 — Firmware C/C++ embarqué (workflow sans superpowers)
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** firmware pour microcontrôleur STM32 (C, bare-metal). Pas de réseau, pas de frontend, pas de Docker. L'outillage standard de superpowers (brainstorming Socratique, subagent pipeline) est surdimensionné pour ce contexte.
|
|
|
|
|
-
|
|
|
|
|
-**Setup plugins :**
|
|
|
|
|
-```
|
|
|
|
|
-/plugin-check "Firmware C STM32, bare-metal, pas de réseau, pas de frontend, pas de Docker"
|
|
|
|
|
-
|
|
|
|
|
-SIGNALS: simple, CLI/embedded
|
|
|
|
|
-COST: ~800t (superpowers seul)
|
|
|
|
|
-
|
|
|
|
|
-RECOMMENDATIONS:
|
|
|
|
|
- OK KEEP : superpowers (peut être utile pour brainstorm initial)
|
|
|
|
|
- DISABLE : frontend-design, ui-ux-pro-max, gstack, context7, ruflo
|
|
|
|
|
- NOTE : Pour un firmware vraiment simple (hotfix, modification ciblée),
|
|
|
|
|
- même superpowers peut être désactivé → ~0t passif
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-**Workflow minimaliste — modification d'un driver existant :**
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-# Pas de /init-project, pas de GSD, pas de superpowers
|
|
|
|
|
-
|
|
|
|
|
-# 1. Comprendre avant de modifier
|
|
|
|
|
-/analyze src/drivers/uart.c
|
|
|
|
|
-
|
|
|
|
|
-OUTPUT:
|
|
|
|
|
- ANALYSIS: src/drivers/uart.c
|
|
|
|
|
- CONTEXT: Driver UART pour STM32F4, DMA en mode circulaire
|
|
|
|
|
- KEY COMPONENTS:
|
|
|
|
|
- uart_init(): 45 lignes — config registres + DMA
|
|
|
|
|
- uart_send(): 12 lignes — écriture dans ring buffer
|
|
|
|
|
- UART_IRQHandler(): 28 lignes — ISR, gère overrun
|
|
|
|
|
- RISKS:
|
|
|
|
|
- - uart_init() dépasse 25 lignes → split candidat
|
|
|
|
|
- - Accès non-atomique à ring_buffer_head dans ISR — probability: high
|
|
|
|
|
- OPEN QUESTIONS:
|
|
|
|
|
- - Quid si DMA transfer pas terminé avant appel uart_send() ?
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-**Modification chirurgicale :**
|
|
|
|
|
-```
|
|
|
|
|
-/ship-feature "Corriger l'accès non-atomique au ring_buffer_head dans l'ISR"
|
|
|
|
|
-
|
|
|
|
|
-STEP 0b — CLAUDE.md found
|
|
|
|
|
-STEP 0 — plugin check: superpowers OK (ou désactivé si YOLO mode)
|
|
|
|
|
-
|
|
|
|
|
-STEP 1 — BRAINSTORM (rapide, contexte déjà clair depuis /analyze):
|
|
|
|
|
- Design: protéger ring_buffer_head avec __disable_irq()/__enable_irq()
|
|
|
|
|
- ou utiliser un flag volatile + memory barrier
|
|
|
|
|
|
|
+STEP 1 — BRAINSTORM (rapide, contexte déjà clair depuis /analyze):
|
|
|
|
|
+ Design: protéger ring_buffer_head avec __disable_irq()/__enable_irq()
|
|
|
|
|
+ ou utiliser un flag volatile + memory barrier
|
|
|
|
|
|
|
|
STEP 3 — VALIDATION GATE:
|
|
STEP 3 — VALIDATION GATE:
|
|
|
TASKS: 2
|
|
TASKS: 2
|
|
@@ -1494,566 +941,6 @@ STEP 4 — IMPLEMENT (subagents légers, modifications chirurgicales)
|
|
|
- `/analyze` est particulièrement utile sur du code C bas-niveau : l'analyzer identifie les accès non-atomiques, les race conditions, les violations de normes, **sans proposer de fix**.
|
|
- `/analyze` est particulièrement utile sur du code C bas-niveau : l'analyzer identifie les accès non-atomiques, les race conditions, les violations de normes, **sans proposer de fix**.
|
|
|
- Pour un firmware, le workflow `analyze → ship-feature` peut se réduire à `analyze → edit direct` si la modification est triviale.
|
|
- Pour un firmware, le workflow `analyze → ship-feature` peut se réduire à `analyze → edit direct` si la modification est triviale.
|
|
|
- GSD v2 n'est jamais pertinent pour du firmware : les sessions sont courtes et les tâches atomiques.
|
|
- GSD v2 n'est jamais pertinent pour du firmware : les sessions sont courtes et les tâches atomiques.
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-## Cas de figure — corrections v2.6.0 validées
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas V — `/status` compte les slices, pas les tasks
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** `.gsd/ROADMAP.md` avec 3 milestones, chacun subdivisé en slices (`###`) contenant des tasks (`- [ ]`).
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.6.0 :** comptait `- [x]` = nombre de tasks terminées → résultat faux (ex: `6/8 "slices"` alors que c'était des tasks).
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.6.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-ROADMAP.md:
|
|
|
|
|
- ## Milestone 1 — Auth [x]
|
|
|
|
|
- ### Slice 1 — JWT setup [x] ← slice terminée
|
|
|
|
|
- ### Slice 2 — Login UI [x] ← slice terminée
|
|
|
|
|
- ## Milestone 2 — Boutique
|
|
|
|
|
- ### Slice 3 — Cart UI [x] ← slice terminée
|
|
|
|
|
- ### Slice 4 — Stripe checkout ← en cours
|
|
|
|
|
- ### Slice 5 — Webhook handler ← en attente
|
|
|
|
|
-
|
|
|
|
|
-/status → GSD v2 : Progress = 3/5 slices done (60%)
|
|
|
|
|
- Milestone actuel : Milestone 2 — Boutique
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-3/5 correspond exactement au dashboard GSD v2.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas W — `/ship-feature` affiche le contexte projet dès STEP 0b
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.6.0 :** STEP 0b trouvait CLAUDE.md → continuait silencieusement. Pas de rappel de contexte.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.6.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-/ship-feature "Ajouter webhook Stripe"
|
|
|
|
|
-
|
|
|
|
|
-STEP 0b — CLAUDE.md found
|
|
|
|
|
-📋 PROJECT CONTEXT
|
|
|
|
|
- Project : CardForge
|
|
|
|
|
- Stack : React 18 + FastAPI + PostgreSQL + Docker
|
|
|
|
|
- Branch : feature/stripe-integration
|
|
|
|
|
- Recent : feat: add cart persistence
|
|
|
|
|
- feat: implement collection display
|
|
|
|
|
- chore: setup Stripe SDK
|
|
|
|
|
- GSD : Milestone 2 — Boutique (3/5 slices)
|
|
|
|
|
-
|
|
|
|
|
-→ STEP 1 — BRAINSTORM
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Developer se réoriente instantanément — pas de risque d'implémenter sur la mauvaise branche.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas X — session-start : 6 plugins actifs, tous affichés
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-┌─ Claude Code config ──────────────────────────────────┐
|
|
|
|
|
-│ ✅ ON : security-guidance rtk superpowers │
|
|
|
|
|
-│ 🟢 ON : gstack frontend-design ui-ux-pro-max context7│
|
|
|
|
|
-│ ruflo plugin-dev │
|
|
|
|
|
-│ ⚫ OFF : none │
|
|
|
|
|
-│ 💰 ~5750t passif (52% budget) │
|
|
|
|
|
-│ 📦 v2.6.0 │
|
|
|
|
|
-└───────────────────────────────────────────────────────┘
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Tous les 6 plugins actifs visibles. Ligne de continuation alignée avec la ligne principale.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas Y — Exemple 8 en action : reprise de session CardForge
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-# Dans Claude Code
|
|
|
|
|
-/status
|
|
|
|
|
-→ 3/5 slices, branche feature/stripe-integration, 1 fichier uncommitted
|
|
|
|
|
-
|
|
|
|
|
-# Dans un terminal
|
|
|
|
|
-gsd
|
|
|
|
|
-/gsd (step mode — relire le plan avant d'exécuter)
|
|
|
|
|
-
|
|
|
|
|
-# Architecture change détectée pendant la pause
|
|
|
|
|
-/gsd discuss "Je veux PaymentElement pas CardElement"
|
|
|
|
|
-→ Plan mis à jour
|
|
|
|
|
-
|
|
|
|
|
-# Reprendre l'exécution autonome
|
|
|
|
|
-/gsd auto
|
|
|
|
|
-→ GSD exécute Slice 4 avec le plan mis à jour, commits propres
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Cycle complet : orientation → vérification plan → décision → exécution. Zero perte de contexte.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-## Cas de figure — corrections v2.7.0 validées
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas Z1 — `/status` détecte le bon milestone courant
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.7.0 :** `grep -E '^## ' | tail -5` → retournait les 5 derniers headings `##`, pouvait inclure des milestones **terminés** comme courant.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.7.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-ROADMAP.md:
|
|
|
|
|
- ## Milestone 1 — Auth [x]
|
|
|
|
|
- ### Slice 1 — JWT [x]
|
|
|
|
|
- ## Milestone 2 — Boutique
|
|
|
|
|
- ### Slice 3 — Cart UI [x]
|
|
|
|
|
- ### Slice 4 — Stripe checkout ← première slice en attente
|
|
|
|
|
-
|
|
|
|
|
-awk scan top-to-bottom:
|
|
|
|
|
- → Slice 4 n'a pas [x] → milestone courant = "Milestone 2 — Boutique" ✓
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas Z2 — `/status` affiche l'état des tests
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** projet Python, dernier pytest avec 1 test échoué.
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-/status
|
|
|
|
|
-
|
|
|
|
|
-PROJECT
|
|
|
|
|
- CLAUDE.md : found
|
|
|
|
|
- Stack : FastAPI / PostgreSQL
|
|
|
|
|
- Branch : feature/notifications
|
|
|
|
|
- Uncommitted : 2 files
|
|
|
|
|
- Tests : 1 failing (test_email_worker.py::test_retry)
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Developer voit immédiatement le test cassé avant de relancer GSD.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas Z3 — `/ship-feature` : commits tronqués à 50 chars
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-📋 PROJECT CONTEXT
|
|
|
|
|
- Recent : a1b2c3d feat: add Stripe PaymentIntent creation wi...
|
|
|
|
|
- e4f5g6h fix: jwt token refresh not working on mobi...
|
|
|
|
|
- i7j8k9l chore: update all dependencies to latest v...
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Messages complets disponibles via `git log` — le contexte PROJECT affiche uniquement les 50 premiers caractères.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas Z4 — `doctor.sh` détecte `lib/` non symlinké
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-bash doctor.sh
|
|
|
|
|
-
|
|
|
|
|
-── Symlinks ──
|
|
|
|
|
- ✓ ~/.claude/CLAUDE.md
|
|
|
|
|
- ...
|
|
|
|
|
- ⚠ ~/.claude/lib exists but is NOT a symlink
|
|
|
|
|
- ✓ ~/.claude/hooks/session-start.sh
|
|
|
|
|
- → Symlinks: 6/7 OK
|
|
|
|
|
-
|
|
|
|
|
-Fix: mv ~/.claude/lib ~/.claude/lib.bak && bash link.sh
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Si `lib/` n'est pas un symlink vers le repo, `detect-plugins.sh` sourcé est la version installée localement — potentiellement périmée.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas Z5 — plugin-advisor warn sur plugin-dev inactif
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** projet React SaaS, `plugin-dev` resté actif par oubli.
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-/plugin-check "React SaaS avec FastAPI"
|
|
|
|
|
-
|
|
|
|
|
-SIGNALS: frontend, deploy, fast-libs(React)
|
|
|
|
|
-
|
|
|
|
|
-WARN: plugin-dev ON — aucun signal skill-creation détecté
|
|
|
|
|
- → ~100t économisés si désactivé
|
|
|
|
|
- → Activer uniquement quand vous créez des skills custom
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas Z6 — Firmware C STM32 : aucun plugin inutile
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-/plugin-check "Firmware C STM32, bare-metal, I2C driver"
|
|
|
|
|
-
|
|
|
|
|
-SIGNALS: simple, embedded
|
|
|
|
|
-COST: ~800t (superpowers seul)
|
|
|
|
|
-
|
|
|
|
|
-DISABLE: frontend-design, ui-ux-pro-max, gstack, context7, ruflo, plugin-dev
|
|
|
|
|
-NOTE: Pour hotfix ultra-ciblé, superpowers aussi optionnel
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Pipeline complet disponible : `/analyze` → `/ship-feature` avec 0 overhead de plugins inutiles. Voir Exemple 9 pour le détail.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-## Cas de figure — corrections v2.8.0 validées
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AA — awk portable : milestone courant sur macOS et Linux
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-ROADMAP:
|
|
|
|
|
- ## Milestone 1 — Auth [x]
|
|
|
|
|
- ### Slice 1 — JWT [x]
|
|
|
|
|
- ## Milestone 2 — Boutique
|
|
|
|
|
- ### Slice 3 — Cart UI [x]
|
|
|
|
|
- ### Slice 4 — Stripe checkout ← pas de [x]
|
|
|
|
|
-
|
|
|
|
|
-awk scan (index() au lieu de regex):
|
|
|
|
|
- ## Milestone 2 → ms = "## Milestone 2 — Boutique"
|
|
|
|
|
- ### Slice 3 [x] → index = 14 ≠ 0 → skip
|
|
|
|
|
- ### Slice 4 → index = 0 → PRINT "## Milestone 2" → EXIT ✓
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Fonctionne identiquement sur GNU awk (Linux) et nawk (macOS).
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AB — Tests field : fallback sur la commande de test
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-Projet Node.js, pas de run récent, mais package.json présent:
|
|
|
|
|
-
|
|
|
|
|
-/status → Tests: run 'jest --coverage' to check
|
|
|
|
|
-
|
|
|
|
|
-Projet Rust (pas de CI log):
|
|
|
|
|
-/status → Tests: run 'cargo test' to check
|
|
|
|
|
-
|
|
|
|
|
-Firmware C (pas de test infra du tout):
|
|
|
|
|
-/status → Tests: N/A
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Plus jamais "unknown" quand il y a un test script défini.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AC — signal `embedded` sur firmware ESP32
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-/plugin-check "Firmware ESP32 WiFi driver, FreeRTOS, C"
|
|
|
|
|
-
|
|
|
|
|
-SIGNALS: embedded (ESP32, Firmware, FreeRTOS détectés)
|
|
|
|
|
-NOTE: embedded project detected — minimal plugin footprint
|
|
|
|
|
-
|
|
|
|
|
-RECOMMENDATIONS:
|
|
|
|
|
- superpowers OPTIONAL
|
|
|
|
|
- DISABLE: tout le reste (frontend-design, gstack, context7, ruflo, plugin-dev)
|
|
|
|
|
- gsd v2: NOT recommended
|
|
|
|
|
-
|
|
|
|
|
-Workflow: /analyze src/wifi_driver.c → /ship-feature si multi-fichiers
|
|
|
|
|
-COST: ~800t (ou 0 si superpowers désactivé)
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AD — doctor.sh liste les 8 agents
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-── Consistency ──
|
|
|
|
|
- ✓ All 8 agents present (analyzer, interviewer, plugin-advisor, readme-updater,
|
|
|
|
|
- refactorer, scaffolder, onboarder, status-reporter)
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Confirme visuellement la présence de `onboarder` et `status-reporter` (ajoutés en v2.4.0).
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AE — Arbre de décision "Quel skill utiliser ?"
|
|
|
|
|
-
|
|
|
|
|
-| Situation | Skill |
|
|
|
|
|
-|---|---|
|
|
|
|
|
-| Bug dans API FastAPI existante | `/ship-feature` |
|
|
|
|
|
-| Comprendre un module avant modifier | `/analyze` |
|
|
|
|
|
-| Reprise après 4 jours | `/status` |
|
|
|
|
|
-| Install Claude Code cassée | `/health` |
|
|
|
|
|
-| App Flutter from scratch | `/init-project` |
|
|
|
|
|
-| Quels plugins pour React ? | `/plugin-check` |
|
|
|
|
|
-
|
|
|
|
|
-L'arbre de décision est maintenant disponible en début de USAGE.md (section "Quel skill utiliser ?").
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-## Cas de figure — corrections v2.9.0 validées
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AF — signal `embedded` détecté depuis le filesystem
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** dossier firmware ESP32, `platformio.ini` présent, `src/*.c`, pas de `package.json`. L'utilisateur tape `/plugin-check` sans argument.
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.9.0 :** aucun signal détecté → recommandations génériques.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.9.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-/plugin-check (sans argument, depuis le dossier firmware)
|
|
|
|
|
-
|
|
|
|
|
-PHASE 1 filesystem scan:
|
|
|
|
|
- platformio.ini → FOUND → signal embedded
|
|
|
|
|
-
|
|
|
|
|
-SIGNALS: embedded (platformio.ini)
|
|
|
|
|
-NOTE: embedded project detected — minimal plugin footprint
|
|
|
|
|
-
|
|
|
|
|
-KEEP : superpowers (optional)
|
|
|
|
|
-DISABLE: frontend-design, ui-ux-pro-max, gstack, context7, ruflo, plugin-dev
|
|
|
|
|
-gsd v2 : NOT recommended (sessions courtes, tâches atomiques)
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AG — ROADMAP.md flat (pas de `###` slices)
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** GSD v2 initialisé avec un ROADMAP minimal : tasks directement sous `##`, sans `### Slice`.
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.9.0 :** awk ne trouvait aucun `###` → retournait `"all milestones complete"` → faux.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.9.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-ROADMAP:
|
|
|
|
|
- ## Milestone 2 — Core
|
|
|
|
|
- - [x] Create models
|
|
|
|
|
- - [ ] Implement CRUD ← task en attente
|
|
|
|
|
-
|
|
|
|
|
-awk fallback flat:
|
|
|
|
|
- → "## Milestone 2 — Core (flat)"
|
|
|
|
|
-
|
|
|
|
|
-/status → GSD v2: Milestone 2 — Core (flat)
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AH — pytest cache `{}` = all passing
|
|
|
|
|
-
|
|
|
|
|
-**Avant v2.9.0 :** `cat .pytest_cache/.../lastfailed` affichait `{}` littéralement.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v2.9.0 :**
|
|
|
|
|
-```python
|
|
|
|
|
-d = json.load(open('.pytest_cache/v/cache/lastfailed'))
|
|
|
|
|
-# d = {} → n = 0
|
|
|
|
|
-# Output: "pytest: all passing"
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AI — Refactoring profond : cycle `/analyze` → `/refactor` → `/analyze`
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-# Étape 1 : comprendre avant de toucher
|
|
|
|
|
-/analyze src/payment/
|
|
|
|
|
-→ RISKS: process_payment 95 lignes, global non-mockable, 0 tests
|
|
|
|
|
-
|
|
|
|
|
-# Étape 2 : corriger sur la base du rapport
|
|
|
|
|
-/refactor src/payment/
|
|
|
|
|
-→ split, injection, tests ajoutés
|
|
|
|
|
-
|
|
|
|
|
-# Étape 3 : confirmer que les violations sont résolues
|
|
|
|
|
-/analyze src/payment/
|
|
|
|
|
-→ VIOLATIONS FIXED: 95→18 lignes, injectable ✓
|
|
|
|
|
-→ TESTS: 8 passing
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Ce cycle est maintenant documenté dans l'arbre de décision ("Quel skill utiliser ?").
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AJ — README renvoie vers USAGE.md
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-# claude-config
|
|
|
|
|
-
|
|
|
|
|
-Global Claude Code configuration...
|
|
|
|
|
-
|
|
|
|
|
-> Guide d'utilisation complet : voir USAGE.md — workflows typiques, exemples
|
|
|
|
|
-> par type de projet, arbre de décision, cas validés...
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Un nouvel utilisateur trouve immédiatement le guide pratique.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-## Cas de figure — corrections v3.0.0 validées
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AK — Rust FFI : plus de faux positif embedded
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** bibliothèque Rust avec bindings C (FFI). `tests/c_binding_test.c` présent mais c'est du Rust, pas du firmware.
|
|
|
|
|
-
|
|
|
|
|
-**Avant v3.0.0 :** présence de `.c` → signal embedded → recommandations firmware inutiles.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v3.0.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-PHASE 1: ls platformio.ini → absent, ls *.ld → absent
|
|
|
|
|
-Signal embedded: NOT detected ✓
|
|
|
|
|
-
|
|
|
|
|
-SIGNALS: none (Rust library)
|
|
|
|
|
-→ workflow normal Rust, superpowers + context7
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Seuls `platformio.ini` ou un linker script `*.ld` déclenchent le signal embedded.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AL — ROADMAP avec `## Prerequisites` (faux positif évité)
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** ROADMAP.md avec sections `## Overview`, `## Prerequisites`, puis `## Milestone 1`.
|
|
|
|
|
-
|
|
|
|
|
-**Avant v3.0.0 :** awk flat matchait `## Prerequisites → - [ ] Node 22` → fausse progression.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v3.0.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-awk scoped:
|
|
|
|
|
- ## Overview → ms="" (non-Milestone)
|
|
|
|
|
- - [ ] review → ms="" → SKIP ✓
|
|
|
|
|
- ## Prerequisites → ms="" (non-Milestone)
|
|
|
|
|
- - [ ] Node 22 → ms="" → SKIP ✓
|
|
|
|
|
- ## Milestone 1 — Auth → ms="## Milestone 1"
|
|
|
|
|
- - [ ] Login UI → PRINT "## Milestone 1 (flat)" ✓
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AM — Projet Go : commande de test affichée
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-/status (projet Go avec go.mod)
|
|
|
|
|
-
|
|
|
|
|
-Tests: run 'go test ./...' to check
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Couverture: Python (`pytest`), Node.js (`jest`), Rust (`cargo test`), Go (`go test ./...`).
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AN — `/analyze` : mode DEBUG découvrable via argument-hint
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-Dans Claude Code, argument-hint visible:
|
|
|
|
|
- /analyze <file/area — OR paste error/stack trace for DEBUG mode>
|
|
|
|
|
-
|
|
|
|
|
-→ /analyze "TypeError at CartSummary.tsx:47 — Cannot read 'map' of undefined"
|
|
|
|
|
-→ DEBUG MODE activé automatiquement ✓
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AO — GSD v2 interrompu : reprise depuis l'arbre de décision
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-Arbre: "Session GSD v2 interrompue ?"
|
|
|
|
|
-→ gsd → /gsd auto (reprend depuis .gsd/)
|
|
|
|
|
-→ /gsd steer (modifier le plan)
|
|
|
|
|
-→ /gsd forensics (analyser un échec)
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-GSD v2 reprend automatiquement depuis `.gsd/` — l'utilisateur n'a pas besoin de recommencer.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-## Cas de figure — corrections v3.1.0 validées
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AP — STM32 avec Makefile+C : signal embedded retrouvé
|
|
|
|
|
-
|
|
|
|
|
-**Contexte :** firmware STM32, `Makefile` + `src/main.c`, pas de `platformio.ini`, pas de `*.ld` séparé (linker inline dans Makefile).
|
|
|
|
|
-
|
|
|
|
|
-**Avant v3.1.0 :** `Makefile` retiré en v3.0.0 → signal absent → recommandations génériques.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v3.1.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-PHASE 1: ls Makefile → FOUND, ls src/*.c → 3 fichiers C
|
|
|
|
|
- ls package.json Cargo.toml go.mod → absent
|
|
|
|
|
-
|
|
|
|
|
-Signal embedded: DETECTED (Makefile + .c + no ecosystem)
|
|
|
|
|
-→ DISABLE all toggles, superpowers optional ✓
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AQ — Rust FFI : toujours pas de faux positif
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-Cargo.toml présent + src/ffi.c
|
|
|
|
|
-→ Signal embedded: NOT detected (Cargo.toml = contre-indicateur) ✓
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AR — Onboarder PHASE 6 : ROADMAP.md généré même sans GSD installé
|
|
|
|
|
-
|
|
|
|
|
-**Avant v3.1.0 :** `gsd init` échouait silencieusement si GSD absent.
|
|
|
|
|
-
|
|
|
|
|
-**Avec v3.1.0 :**
|
|
|
|
|
-```
|
|
|
|
|
-PHASE 6 — command -v gsd → NOT FOUND
|
|
|
|
|
-
|
|
|
|
|
-⚠️ GSD v2 not installed — run: npm install -g gsd-pi
|
|
|
|
|
-ROADMAP.md generated (ready to use once GSD is installed).
|
|
|
|
|
-After installing: gsd → /gsd auto
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-ROADMAP.md est utile même sans GSD installé — l'utilisateur peut l'installer plus tard.
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AS — `doctor.sh` détecte skill `/status` manquant
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-bash doctor.sh
|
|
|
|
|
-
|
|
|
|
|
-── Consistency ──
|
|
|
|
|
- ⚠ Missing skills: status/ — run: bash link.sh
|
|
|
|
|
- ✓ All 8 agents present (...)
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-### Cas AT — Token cost visible sur les patterns
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-### Pattern A — Nouveau projet court (≤1 session) · ~3000-5000t
|
|
|
|
|
-
|
|
|
|
|
-Budget Pro note:
|
|
|
|
|
- /init-project ≈ 3000-5000t ≈ 30-45% d'une session Pro (~11k tokens)
|
|
|
|
|
- Planifier les grosses features sur des sessions séparées.
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
----
|
|
|
|
|
-
|
|
|
|
|
-## Erreurs fréquentes — diagnostic rapide
|
|
|
|
|
-
|
|
|
|
|
-| Erreur / Symptôme | Cause probable | Solution |
|
|
|
|
|
-|---|---|---|
|
|
|
|
|
-| `⚠️ No CLAUDE.md found` | `/ship-feature` dans un projet non onboardé | `/onboard` d'abord, puis relancer |
|
|
|
|
|
-| `command not found: gsd` | GSD v2 non installé ou pas dans PATH | `npm install -g gsd-pi` puis `source ~/.bashrc` |
|
|
|
|
|
-| `MISSING: ~/.claude/templates` dans doctor.sh | Installation pre-v2.0.0, `link.sh` pas rejoué | `cd /path/to/claude-config && bash link.sh` |
|
|
|
|
|
-| Scaffolder échoue sur projet Flutter | `flutter` non installé ou pas dans PATH | Installer Flutter SDK, puis `flutter doctor` |
|
|
|
|
|
-| Scaffolder échoue sur projet Expo | `npx` non disponible ou Node < 18 | `node --version` → mettre à jour Node si < 18 |
|
|
|
|
|
-| Plugin-check recommande gstack sur mobile | Signal `mobile` non détecté (manque RN/Expo/Flutter dans description) | Ajouter "React Native" ou "Flutter" explicitement dans le prompt |
|
|
|
|
|
-| Plugin-check recommande gstack sur monorepo sans browser QA | Signal `monorepo` non détecté | Vérifier que `apps/` ou `turbo.json` est détecté ; relancer depuis la racine du monorepo |
|
|
|
|
|
-| Session-start box mal alignée | Version < v2.3.0 | Mettre à jour depuis l'archive v2.3.0+ |
|
|
|
|
|
-| `/init-project` pose des questions déjà dans le prompt | Prompt incomplet (stack ou features manquants) | Ajouter stack, features v1, et conventions dans le prompt initial |
|
|
|
|
|
-| STEP 13 `gsd init` : "command not found" | GSD v2 non installé au moment de init-project | `npm install -g gsd-pi`, puis `/onboard add gsd` |
|
|
|
|
|
-| Plugin-check recommande plugins web sur firmware | signal `embedded` non détecté | Vérifier: `platformio.ini` ou `*.ld` présent, ou `Makefile` + `.c` + pas de `package.json`/`Cargo.toml`/`setup.py` |
|
|
|
|
|
-| `detect_ruflo` retourne faux positif | Ancien MCP config resté dans `~/.claude.json` | Vérifier que `ruflo --version` fonctionne ; ignore les vieux configs MCP |
|
|
|
|
|
-| `doctor.sh` : deny rules count mismatch | `settings.json` modifié manuellement | Vérifier avec `python3 -c "import json; print(len(json.load(open('~/.claude/settings.json'))['permissions']['deny']))"` — attendu : 100 |
|
|
|
|
|
-| Subagent échoue en STEP 4, pas de guidance | Version < v2.2.0 | Mettre à jour, le STEP 4b est ajouté en v2.2.0 |
|
|
|
|
|
-| `/analyze` ne passe pas en mode DEBUG | L'erreur n'est pas passée en argument | Copier l'erreur exacte dans l'argument : `/analyze "FAILED test_foo — TypeError: ..."`|
|
|
|
|
|
-| GStack skills/ manquant | Submodule initialisé mais `./setup` pas exécuté | `cd skills-external/gstack && ./setup` |
|
|
|
|
|
-
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
## Référence rapide — signaux → plugins
|
|
## Référence rapide — signaux → plugins
|
