bchanot/claude
1
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(init-project): doc-sync + doc-commit before FINISH — fixes docs stranded outside PR

Browse Source 
Reorder: SYNC README moves from STEP 12 (post-FINISH) to STEP 10c (after 10b capitalize, before 11 FINISH) and gains lib/doc-commit.md; GSD 13 → 12. Final order: 10b capitalize -> 10c doc-sync -> 11 FINISH -> 12 GSD — both artifact-commits (memory, docs) land before FINISH, so they reach the merge/PR (twin of the ship-feature fix, BDR-034). Partial-fix note added: scaffold + STEP 5b bootstrap-README commit gap (BLK-010) and GSD-post-FINISH ROADMAP (BLK-011) are deliberately out of scope — separate chantiers.

Ref-coherence (the swap flips STEP 12's meaning SYNC-README -> GSD and removes 13, so refs by number must move, not just a vanishing number): PROGRESS PROTOCOL 13-step -> 12-step + STEP <N>/13 -> /12. USAGE.md: 5 refs corrected (table 12-13 -> 11-12 steps; pipeline illustration reworked so sync README shows BEFORE finish; 3 GSD-as-STEP-13 refs -> STEP 12). Each USAGE ref read individually post-swap — all were correct at 13, correct at 12 after fix, none accidentally-true/silently-false. Latent-bug check: init-project had NO stale ref from the capitalize chantier (STEP 10b was a non-shifting letter insertion, not a swap). Historical records (BDR-017 '13 steps', CHANGELOG STEP 13 GSD, BLK-011) left as-is — append-only; closing entry documents the renumber.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ho5EQCFTSvYamuRtVZpp2d
This commit is contained in:
Bastien Chanot
2026-06-27 02:23:16 +02:00
co-authored by Claude Opus 4.8
parent 636b49138c
commit e81f629ac8
2 changed files with 31 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
USAGE.md
+8 -7
View File
@@ -123,7 +123,7 @@ Tu veux...
| Commande | Quand | Notes |
|---|---|---|
| `/init-project` | Nouveau projet from scratch | 12-13 steps, deux gates obligatoires |
| `/init-project` | Nouveau projet from scratch | 11-12 steps, deux gates obligatoires |
| `/ship-feature` | Feature sur projet existant | Pipeline 9 steps, une gate |
| `/feat` | Petite feature (1-5 fichiers) | Léger, pas d'orchestration lourde |
| `/bugfix` | Bug avec investigation root cause | Hypothèses, diagnostic, fix minimal |
@@ -192,9 +192,10 @@ Hotfix/quick fix → tout OFF sauf superpowers
# → STEP 1 : interview (skip si prompt complet)
# → STEP 4 : ★ GATE — valider l'architecture
# → STEP 7 : ★ GATE — valider le plan d'implémentation
# → STEP 8-11: implémentation TDD + review + finish
# → STEP 12 : sync README
# → STEP 13 : propose GSD v2 si multi-session détecté
# → STEP 8-10 : implémentation TDD + review
# → STEP 10b-c: capitalize mémoire + sync README (avant finish)
# → STEP 11 : finish (merge / commit initial)
# → STEP 12 : propose GSD v2 si multi-session détecté
# 3. Features suivantes
/ship-feature "description de la feature"
@@ -203,7 +204,7 @@ Hotfix/quick fix → tout OFF sauf superpowers
### Pattern B — Projet long (multi-session, plusieurs jours) · ~1500-2500t/session CC
```
# Même départ que Pattern A, mais au STEP 13 :
# Même départ que Pattern A, mais au STEP 12 :
# → Répondre "yes" à "Initialize GSD v2?"
# → ROADMAP.md est créé avec les milestones
@@ -399,7 +400,7 @@ Verify : npx expo export --platform web --output-dir /tmp/expo-check --clear
**Si le projet devient long (plusieurs features sur semaines) :**
```
# STEP 13 propose GSD v2 : répondre "yes"
# STEP 12 propose GSD v2 : répondre "yes"
# Puis dans terminal :
gsd
/gsd auto
@@ -500,7 +501,7 @@ Convention: snake_case Python, camelCase TypeScript."
**Workflow long avec GSD v2 :**
```
# Après /init-project (STEP 13 → "yes")
# Après /init-project (STEP 12 → "yes")
# Le ROADMAP.md généré contient :
# Milestone 1: Boutique in-app + Stripe
# Milestone 2: PvP + matchmaking