cc-ship 0.0.6 → 0.0.8

package/commands/ship/brainstorm.md

@@ -1,75 +1,84 @@
----
-name: ship:brainstorm
-description: "Lance une session de brainstorming interactive"
----
-
-# Commande brainstorm
-
-Lance l'agent ship-brainstormer pour transformer une idée vague en brief structuré.
-
-## Instructions
-
-Tu dois lancer l'agent `ship-brainstormer` en utilisant le tool Task avec les paramètres suivants:
-
-```
-subagent_type: ship-brainstormer
-prompt: [Le contexte de l'utilisateur ou "Démarre une nouvelle session de brainstorming"]
-```
-
-## ⚠️ Comportement de relais (IMPORTANT)
-
-Tu es un **relais transparent** entre l'agent et l'utilisateur.
-
-Quand l'agent te retourne une question pour l'utilisateur :
-1. **Utilise `AskUserQuestion`** pour la poser exactement comme l'agent l'a formulée
-2. Récupère la réponse de l'utilisateur
-3. Relance l'agent avec cette réponse
-
-**Ce que tu ne fais JAMAIS** :
-- ❌ Résumer les questions de l'agent
-- ❌ Reformuler ce que l'agent demande
-- ❌ Répondre à la place de l'utilisateur
-- ❌ Dire "l'agent te demande si..." au lieu d'utiliser AskUserQuestion
-
-**Ce que tu fais TOUJOURS** :
-- ✅ Utiliser AskUserQuestion avec la question exacte de l'agent
-- ✅ Passer la réponse de l'utilisateur à l'agent
-- ✅ Continuer jusqu'à ce que l'agent ait terminé
-
-## Comportement attendu
-
-1. Si l'utilisateur a fourni une idée avec la commande, passe-la à l'agent
-2. Si aucune idée n'est fournie, l'agent demandera à l'utilisateur de décrire son idée
-3. L'agent va:
-   - Proposer une recherche sur le domaine (optionnel)
-   - Recommander une technique de brainstorming
-   - Mener une session interactive
-   - Produire un brief structuré dans `.ship/brief.md`
-
-## Exemple d'utilisation
-
-```
-/ship:brainstorm J'ai une idée d'app pour aider les gens à mieux dormir
-```
-
-ou simplement:
-
-```
-/ship:brainstorm
-```
-
-## Output
-
-**Fichiers générés** :
-- `.ship/brief.md` : Le brief structuré
-- `.ship/research.md` : Research domaine métier (optionnel, si demandé)
-
-**Structure du brief** :
-- L'idée en une phrase
-- Contexte
-- Objectifs
-- Utilisateurs cibles
-- Contraintes connues
-- Premières idées / Directions
-- Questions ouvertes
-- Research (référence vers `.ship/research.md` si effectuée)
+---
+name: ship:brainstorm
+description: "Lance une session de brainstorming interactive"
+---
+
+# Commande brainstorm
+
+Lance l'agent ship-brainstormer pour transformer une idée vague en brief structuré.
+
+## Instructions
+
+### Résolution du projet (PREMIÈRE ÉTAPE)
+
+1. Lire `cc-ship.json` à la racine du repo
+2. Résoudre le chemin : `{projectsDir}/{currentProject}/`
+3. Si `cc-ship.json` n'existe pas OU `currentProject` est null → ERREUR : "Lance `/ship:init` ou `/ship:next` d'abord pour initialiser un projet."
+4. Utiliser ce chemin partout au lieu de `.ship/`
+
+### Lancement de l'agent
+
+Tu dois lancer l'agent `ship-brainstormer` en utilisant le tool Task avec les paramètres suivants:
+
+```
+subagent_type: ship-brainstormer
+prompt: "Le chemin du projet est {projectPath}. [Le contexte de l'utilisateur ou 'Démarre une nouvelle session de brainstorming']"
+```
+
+## ⚠️ Comportement de relais (IMPORTANT)
+
+Tu es un **relais transparent** entre l'agent et l'utilisateur.
+
+Quand l'agent te retourne une question pour l'utilisateur :
+1. **Utilise `AskUserQuestion`** pour la poser exactement comme l'agent l'a formulée
+2. Récupère la réponse de l'utilisateur
+3. Relance l'agent avec cette réponse
+
+**Ce que tu ne fais JAMAIS** :
+- ❌ Résumer les questions de l'agent
+- ❌ Reformuler ce que l'agent demande
+- ❌ Répondre à la place de l'utilisateur
+- ❌ Dire "l'agent te demande si..." au lieu d'utiliser AskUserQuestion
+
+**Ce que tu fais TOUJOURS** :
+- ✅ Utiliser AskUserQuestion avec la question exacte de l'agent
+- ✅ Passer la réponse de l'utilisateur à l'agent
+- ✅ Continuer jusqu'à ce que l'agent ait terminé
+
+## Comportement attendu
+
+1. Si l'utilisateur a fourni une idée avec la commande, passe-la à l'agent
+2. Si aucune idée n'est fournie, l'agent demandera à l'utilisateur de décrire son idée
+3. L'agent va:
+   - Proposer une recherche sur le domaine (optionnel)
+   - Recommander une technique de brainstorming
+   - Mener une session interactive
+   - Produire un brief structuré dans `{projectPath}/brief.md`
+
+## Exemple d'utilisation
+
+```
+/ship:brainstorm J'ai une idée d'app pour aider les gens à mieux dormir
+```
+
+ou simplement:
+
+```
+/ship:brainstorm
+```
+
+## Output
+
+**Fichiers générés** (dans le dossier projet) :
+- `brief.md` : Le brief structuré
+- `research.md` : Research domaine métier (optionnel, si demandé)
+
+**Structure du brief** :
+- L'idée en une phrase
+- Contexte
+- Objectifs
+- Utilisateurs cibles
+- Contraintes connues
+- Premières idées / Directions
+- Questions ouvertes
+- Research (référence vers `research.md` si effectuée)

package/commands/ship/execute.md

@@ -9,11 +9,20 @@ Lance l'agent ship-executor pour implementer UN scope d'un package en respectant
 
 ## Instructions
 
+### Resolution du projet (PREMIERE ETAPE)
+
+1. Lire `cc-ship.json` a la racine du repo
+2. Resoudre le chemin : `{projectsDir}/{currentProject}/`
+3. Si `cc-ship.json` n'existe pas OU `currentProject` est null → ERREUR : "Lance `/ship:init` ou `/ship:next` d'abord pour initialiser un projet."
+4. Utiliser ce chemin partout au lieu de `.ship/`
+
+### Lancement de l'agent
+
 Tu dois lancer l'agent `ship-executor` en utilisant le tool Task avec les parametres suivants:
 
 ```
 subagent_type: ship-executor
-prompt: [Le package et/ou scope a executer]
+prompt: "Le chemin du projet est {projectPath}. [Le package et/ou scope a executer]"
 ```
 
 ## Prerequis
@@ -22,10 +31,10 @@ Avant de lancer l'agent, verifie que ces fichiers existent :
 
 | Fichier | Obligatoire | Cree par |
 |---------|-------------|----------|
-| `.ship/packages/<nom>/package.md` | Oui | shaper |
-| `.ship/packages/<nom>/verification.md` | Oui | shaper |
-| `.ship/architecture.md` | Oui | architect |
-| `.ship/requirements.md` | Oui | specifier |
+| `{projectPath}/packages/<nom>/package.md` | Oui | shaper |
+| `{projectPath}/packages/<nom>/verification.md` | Oui | shaper |
+| `{projectPath}/architecture.md` | Oui | architect |
+| `{projectPath}/requirements.md` | Oui | specifier |
 
 ### Verification du status
 
@@ -91,16 +100,10 @@ Quand l'agent te retourne une question pour l'utilisateur :
 Execute le scope courant du package actif (detecte automatiquement).
 
 ```
-/ship:execute .ship/packages/auth/package.md
-```
-
-Execute le scope courant du package specifie.
-
-```
-/ship:execute .ship/packages/auth/package.md scope-2
+/ship:execute auth
 ```
 
-Execute un scope specifique du package.
+Execute le scope courant du package "auth".
 
 ```
 /ship:execute auth

package/commands/ship/help.md

@@ -1,105 +1,111 @@
----
-name: ship:help
-description: "Affiche la liste des commandes ship disponibles"
----
-
-# Ship v2 - Aide
-
-Un toolkit pour augmenter Claude Code avec un workflow pragmatique centré sur
-l'interaction avec l'humain.
-
-## Philosophie
-
-- **Pragmatisme** : Get shit done, sans bullshit
-- **Contrôle humain** : L'utilisateur valide, intervient, décide
-- **Shaping avant coding** : On creuse la fonctionnalité à fond, ensuite
-  l'implémentation suit
-
----
-
-## Commandes par phase
-
-### Phase 1 - Idéation
-
-| Commande           | Description                                      |
-| ------------------ | ------------------------------------------------ |
-| `/ship:brainstorm` | Transforme une idée vague en brief structuré     |
-| `/ship:prd`        | Creuse le brief en Product Requirements Document |
-
-### Phase 2 - Spécification
-
-| Commande          | Description                                |
-| ----------------- | ------------------------------------------ |
-| `/ship:specify`   | Transforme le PRD en exigences (SRS)       |
-| `/ship:architect` | Propose ou valide l'architecture technique |
-| `/ship:split`     | Découpe en packages livrables              |
-
-### Phase 3 - Exécution
-
-| Commande        | Description                   |
-| --------------- | ----------------------------- |
-| `/ship:shape`   | Planifie UN package en scopes |
-| `/ship:execute` | Implémente le scope courant   |
-| `/ship:verify`  | Vérifie l'implémentation      |
-
-### Orchestration
-
-| Commande       | Description                                             |
-| -------------- | ------------------------------------------------------- |
-| `/ship:next`   | Détecte l'état et propose l'étape suivante (interactif) |
-| `/ship:status` | Affiche l'état du projet                                |
-| `/ship:help`   | Affiche cette aide                                      |
-
----
-
-## Flow
-
-```
-BRAINSTORM → PRD → SPECIFY → ARCHITECT → SPLIT
-                                          ↓
-                    ┌─────────────────────┘
-                    ↓
-              Pour CHAQUE package:
-              SHAPE → EXECUTE ←→ VERIFY
-```
-
----
-
-## Structure des fichiers
-
-```
-.ship/
-├── brief.md                      # Output brainstormer
-├── research.md                   # Output brainstormer (optionnel)
-├── prd.md                        # Output brainstormer-prd
-├── requirements.md               # Output specifier (SRS)
-├── architecture.md               # Output architect
-└── packages/
-    ├── mapping.md                # Output splitter
-    └── <nom>/
-        ├── package.md            # Output shaper
-        └── verification.md       # Output shaper
-```
-
----
-
-## Agents
-
-| Agent                 | Rôle                                                       |
-| --------------------- | ---------------------------------------------------------- |
-| ship-brainstormer     | Transforme une idée vague en brief structuré               |
-| ship-brainstormer-prd | Creuse le brief en PRD détaillé                            |
-| ship-specifier        | Définit les exigences fonctionnelles et non-fonctionnelles |
-| ship-architect        | Propose ou valide l'architecture technique                 |
-| ship-splitter         | Découpe en packages livrables                              |
-| ship-shaper           | Planifie un package en scopes                              |
-| ship-executor         | Implémente le scope courant                                |
-| ship-verifier         | Vérifie l'implémentation                                   |
-
----
-
-## Pour commencer
-
-- `/ship:next` pour démarrer ou reprendre le workflow
-- `/ship:brainstorm` pour démarrer un nouveau projet
-- `/ship:status` pour voir où tu en es
+---
+name: ship:help
+description: "Affiche la liste des commandes ship disponibles"
+---
+
+# Ship v2 - Aide
+
+Un toolkit pour augmenter Claude Code avec un workflow pragmatique centré sur
+l'interaction avec l'humain.
+
+## Philosophie
+
+- **Pragmatisme** : Get shit done, sans bullshit
+- **Contrôle humain** : L'utilisateur valide, intervient, décide
+- **Shaping avant coding** : On creuse la fonctionnalité à fond, ensuite
+  l'implémentation suit
+
+---
+
+## Commandes par phase
+
+### Phase 1 - Idéation
+
+| Commande           | Description                                      |
+| ------------------ | ------------------------------------------------ |
+| `/ship:brainstorm` | Transforme une idée vague en brief structuré     |
+| `/ship:prd`        | Creuse le brief en Product Requirements Document |
+
+### Phase 2 - Spécification
+
+| Commande          | Description                                |
+| ----------------- | ------------------------------------------ |
+| `/ship:specify`   | Transforme le PRD en exigences (SRS)       |
+| `/ship:architect` | Propose ou valide l'architecture technique |
+| `/ship:split`     | Découpe en packages livrables              |
+
+### Phase 3 - Exécution
+
+| Commande        | Description                   |
+| --------------- | ----------------------------- |
+| `/ship:shape`   | Planifie UN package en scopes |
+| `/ship:execute` | Implémente le scope courant   |
+| `/ship:verify`  | Vérifie l'implémentation      |
+
+### Orchestration
+
+| Commande       | Description                                             |
+| -------------- | ------------------------------------------------------- |
+| `/ship:init`   | Initialise un nouveau projet ship                       |
+| `/ship:next`   | Détecte l'état et propose l'étape suivante (interactif) |
+| `/ship:status` | Affiche l'état du projet                                |
+| `/ship:help`   | Affiche cette aide                                      |
+
+---
+
+## Flow
+
+```
+BRAINSTORM → PRD → SPECIFY → ARCHITECT → SPLIT
+                                          ↓
+                    ┌─────────────────────┘
+                    ↓
+              Pour CHAQUE package:
+              SHAPE → EXECUTE ←→ VERIFY
+```
+
+---
+
+## Structure des fichiers
+
+```
+cc-ship.json                      # Configuration multi-projet
+{projectsDir}/
+└── {currentProject}/             # Dossier projet actif
+    ├── brief.md                  # Output brainstormer
+    ├── research.md               # Output brainstormer (optionnel)
+    ├── prd.md                    # Output brainstormer-prd
+    ├── requirements.md           # Output specifier (SRS)
+    ├── architecture.md           # Output architect
+    └── packages/
+        ├── mapping.md            # Output splitter
+        └── <nom>/
+            ├── package.md        # Output shaper
+            └── verification.md   # Output shaper
+```
+
+Par défaut, `projectsDir` = `.ship`. Configurable via `cc-ship.json`.
+
+---
+
+## Agents
+
+| Agent                 | Rôle                                                       |
+| --------------------- | ---------------------------------------------------------- |
+| ship-brainstormer     | Transforme une idée vague en brief structuré               |
+| ship-brainstormer-prd | Creuse le brief en PRD détaillé                            |
+| ship-specifier        | Définit les exigences fonctionnelles et non-fonctionnelles |
+| ship-architect        | Propose ou valide l'architecture technique                 |
+| ship-splitter         | Découpe en packages livrables                              |
+| ship-shaper           | Planifie un package en scopes                              |
+| ship-executor         | Implémente le scope courant                                |
+| ship-verifier         | Vérifie l'implémentation                                   |
+
+---
+
+## Pour commencer
+
+- `/ship:init mon-projet` pour initialiser un nouveau projet
+- `/ship:next` pour démarrer ou reprendre le workflow
+- `/ship:brainstorm` pour démarrer le brainstorming
+- `/ship:status` pour voir où tu en es

package/commands/ship/init.md

@@ -0,0 +1,73 @@
+---
+name: ship:init
+description: "Initialise un nouveau projet ship"
+---
+
+# Commande init
+
+Initialise un nouveau projet ship avec son dossier dédié.
+
+## Syntaxe
+
+```
+/ship:init [nom-projet]
+```
+
+## Instructions
+
+### Étape 1 : Résoudre la configuration
+
+1. Lire `cc-ship.json` à la racine du repo
+2. **Si `cc-ship.json` n'existe pas** :
+   - Demander `projectsDir` via `AskUserQuestion` (proposer `.ship` par défaut)
+   - Créer `cc-ship.json` avec le `projectsDir` choisi et `currentProject: null`
+
+3. **Si `cc-ship.json` existe** :
+   - Lire `projectsDir` depuis le fichier
+
+### Étape 2 : Résoudre le nom du projet
+
+1. **Si un nom est fourni en argument** (ex: `/ship:init mon-jeu`) → utiliser ce nom
+2. **Si pas de nom** → demander le nom du projet via `AskUserQuestion`
+
+Le nom du projet doit être un slug valide (lettres minuscules, chiffres, tirets). Si l'utilisateur donne un nom invalide, le slugifier automatiquement et confirmer.
+
+### Étape 3 : Créer le projet
+
+1. Créer le dossier `{projectsDir}/{nom-projet}/`
+2. Mettre à jour `cc-ship.json` avec `currentProject: "{nom-projet}"`
+3. Confirmer :
+
+```
+Projet "{nom-projet}" initialisé dans {projectsDir}/{nom-projet}/.
+Lance /ship:brainstorm pour commencer, ou /ship:next pour le workflow guidé.
+```
+
+## Gestion des erreurs
+
+### Projet déjà existant
+
+Si le dossier `{projectsDir}/{nom-projet}/` existe déjà :
+
+```
+Le projet "{nom-projet}" existe déjà dans {projectsDir}/{nom-projet}/.
+```
+
+Options via `AskUserQuestion` :
+1. **Reprendre ce projet** - Setter `currentProject` et continuer
+2. **Choisir un autre nom** - Demander un nouveau nom
+3. **Annuler** - Ne rien faire
+
+## Exemples
+
+```
+/ship:init mon-jeu
+```
+
+Crée `.ship/mon-jeu/` et configure `cc-ship.json`.
+
+```
+/ship:init
+```
+
+Demande le nom du projet puis le crée.

package/commands/ship/next.md

@@ -9,18 +9,33 @@ Orchestre le workflow ship complet avec validation humaine entre chaque étape.
 
 ## Instructions
 
+### Étape 0 : Résolution du projet (PREMIÈRE ÉTAPE)
+
+1. Lire `cc-ship.json` à la racine du repo
+   - **Si n'existe pas** → demander `projectsDir` via `AskUserQuestion` (proposer `.ship` par défaut) → créer `cc-ship.json`
+
+2. Résoudre le projet :
+   - **Si argument fourni** (ex: `/ship:next mon-jeu`) → setter `currentProject` dans `cc-ship.json`, continuer
+   - **Si pas d'argument ET `currentProject` existe** → l'utiliser SILENCIEUSEMENT (pas de confirmation)
+   - **Si pas d'argument ET `currentProject` est null** → scanner `projectsDir`, lister les projets disponibles, demander lequel via `AskUserQuestion`. Si aucun projet → proposer `/ship:init`
+
+3. Le chemin projet résolu = `{projectsDir}/{currentProject}/`
+   **Utiliser CE chemin partout à la place de `.ship/`**
+
 ### Étape 1 : Détecter l'état actuel
 
 Utilise le même algorithme que `/ship:status` pour détecter l'état du projet.
 
 #### Fichiers à vérifier (dans l'ordre)
 
-1. `.ship/` - Dossier ship
-2. `.ship/brief.md` - Brief (output brainstorm)
-3. `.ship/prd.md` - PRD (output prd)
-4. `.ship/requirements.md` - Spécifications (output specify)
-5. `.ship/architecture.md` - Architecture (output architect)
-6. `.ship/packages/mapping.md` - Mapping (output split)
+1. `{projectPath}/` - Dossier projet
+2. `{projectPath}/brief.md` - Brief (output brainstorm)
+3. `{projectPath}/prd.md` - PRD (output prd)
+4. `{projectPath}/requirements.md` - Spécifications (output specify)
+5. `{projectPath}/architecture.md` - Architecture (output architect)
+6. `{projectPath}/packages/mapping.md` - Mapping (output split)
+
+Où `{projectPath}` = `{projectsDir}/{currentProject}`
 
 #### Pour les packages
 
@@ -37,15 +52,15 @@ current_scope: <nom-du-scope>
 
 ```
 function getNextStep(state):
-    if not exists(.ship/brief.md):
+    if not exists({projectPath}/brief.md):
         return 'brainstorm'
-    if not exists(.ship/prd.md):
+    if not exists({projectPath}/prd.md):
         return 'prd'
-    if not exists(.ship/requirements.md):
+    if not exists({projectPath}/requirements.md):
         return 'specify'
-    if not exists(.ship/architecture.md):
+    if not exists({projectPath}/architecture.md):
         return 'architect'
-    if not exists(.ship/packages/mapping.md):
+    if not exists({projectPath}/packages/mapping.md):
         return 'split'
 
     # Phase packages : boucle shape → execute → verify
@@ -96,7 +111,12 @@ Reposer la question de continuation.
 
 ### Étape 4 : Exécuter l'étape
 
-Lance l'agent approprié via le tool `Task`:
+Lance l'agent approprié via le tool `Task`.
+
+**IMPORTANT** : Quand tu lances un agent, fournis-lui le chemin du projet résolu dans le prompt. Exemple :
+```
+"Le chemin du projet est {projectPath}. Transforme le brief en PRD."
+```
 
 | Étape | Agent | Output |
 |-------|-------|--------|
@@ -183,7 +203,7 @@ Lequel voulez-vous traiter en premier?
 
 ### Reprise après interruption
 
-Les fichiers `.ship/` persistent. Au relancement:
+Les fichiers du projet persistent. Au relancement:
 1. Détecter l'état via les fichiers et front-matter
 2. Proposer de reprendre depuis l'étape en cours
 3. L'utilisateur peut choisir de recommencer une étape
@@ -208,6 +228,7 @@ Le projet ship est complet. Bravo!
 Utilisateur: /ship:next
 
 Next: "Je détecte:
+- Projet actif: mon-jeu (.ship/mon-jeu/)
 - brief.md existe (brainstorm fait)
 - prd.md existe (prd fait)
 - requirements.md n'existe pas
@@ -217,7 +238,7 @@ Continuer?"
 
 Utilisateur: "Oui"
 
-Next: [Lance ship-specifier via Task]
+Next: [Lance ship-specifier via Task avec le chemin du projet]
 ...
 "Specify terminé. requirements.md créé.
 

package/commands/ship/prd.md

@@ -9,19 +9,28 @@ Transforme un brief existant en Product Requirements Document (PRD) structuré.
 
 ## Instructions
 
+### Résolution du projet (PREMIÈRE ÉTAPE)
+
+1. Lire `cc-ship.json` à la racine du repo
+2. Résoudre le chemin : `{projectsDir}/{currentProject}/`
+3. Si `cc-ship.json` n'existe pas OU `currentProject` est null → ERREUR : "Lance `/ship:init` ou `/ship:next` d'abord pour initialiser un projet."
+4. Utiliser ce chemin partout au lieu de `.ship/`
+
+### Lancement de l'agent
+
 Tu dois lancer l'agent `ship-brainstormer-prd` en utilisant le tool Task avec les paramètres suivants:
 
 ```
 subagent_type: ship-brainstormer-prd
-prompt: [Le contexte de l'utilisateur ou "Transforme le brief en PRD"]
+prompt: "Le chemin du projet est {projectPath}. [Le contexte de l'utilisateur ou 'Transforme le brief en PRD']"
 ```
 
 ## ⚠️ Prérequis
 
-Un brief doit exister dans `.ship/brief.md`.
+Un brief doit exister dans `{projectPath}/brief.md`.
 
 **Si aucun brief n'existe** :
-> "Je ne trouve pas de brief dans `.ship/brief.md`. Lance d'abord `/ship:brainstorm` pour créer un brief, puis reviens ici."
+> "Je ne trouve pas de brief dans `{projectPath}/brief.md`. Lance d'abord `/ship:brainstorm` pour créer un brief, puis reviens ici."
 
 ## ⚠️ Comportement de relais (IMPORTANT)
 
@@ -45,12 +54,12 @@ Quand l'agent te retourne une question pour l'utilisateur :
 
 ## Comportement attendu
 
-1. Vérifier que `.ship/brief.md` existe
+1. Vérifier que `{projectPath}/brief.md` existe
 2. L'agent va:
    - Lire le brief et la research (si présente)
    - Poser des questions pour clarifier les features
    - Creuser chaque fonctionnalité identifiée
-   - Produire un PRD structuré dans `.ship/prd.md`
+   - Produire un PRD structuré dans `{projectPath}/prd.md`
 
 ## Exemple d'utilisation
 
@@ -60,8 +69,8 @@ Quand l'agent te retourne une question pour l'utilisateur :
 
 ## Output
 
-**Fichier généré** :
-- `.ship/prd.md` : Le PRD structuré
+**Fichier généré** (dans le dossier projet) :
+- `prd.md` : Le PRD structuré
 
 **Structure du PRD** :
 - Vue d'ensemble (problème, solution, objectifs, personas)