cc-ship 0.0.6 → 0.0.8

package/commands/ship/shape.md

@@ -1,103 +1,112 @@
----
-name: ship:shape
-description: "Lance le shaping d'un package en scopes indépendants"
----
-
-# Commande shape
-
-Lance l'agent ship-shaper pour planifier UN package en scopes indépendants avec critères de vérification.
-
-## Instructions
-
-Tu dois lancer l'agent `ship-shaper` en utilisant le tool Task avec les paramètres suivants:
-
-```
-subagent_type: ship-shaper
-prompt: [Le nom du package à shaper ou "Demande quel package shaper"]
-```
-
-## Prérequis
-
-Avant de lancer l'agent, vérifie que ces fichiers existent :
-
-| Fichier | Obligatoire | Créé par |
-|---------|-------------|----------|
-| `.ship/packages/mapping.md` | Oui | splitter |
-| `.ship/prd.md` | Oui | brainstormer-prd |
-| `.ship/architecture.md` | Oui | architect |
-| `.ship/requirements.md` | Oui | specifier |
-
-Si un fichier manque, indique à l'utilisateur quelle commande lancer :
-- Pas de mapping.md → `/ship:split`
-- Pas de prd.md → `/ship:brainstorm-prd`
-- Pas d'architecture.md → `/ship:architect`
-- Pas de requirements.md → `/ship:specify`
-
-## 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
-
-**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. **Vérifier les prérequis** : mapping.md, prd.md, architecture.md, requirements.md
-
-2. **Identifier le package** :
-   - Si un nom de package est fourni en argument → utiliser ce package
-   - Sinon → l'agent demandera lequel shaper
-
-3. **Lancer l'agent ship-shaper** qui va :
-   - Lire le mapping et les inputs globaux
-   - Extraire les exigences pertinentes
-   - Proposer un découpage en scopes (validation utilisateur)
-   - Définir les must-haves par scope
-   - Définir les critères de vérification
-   - Produire package.md et verification.md
-
-## Syntaxe
-
-```
-/ship:shape
-```
-
-Shape un package (l'agent demandera lequel si plusieurs dans le mapping).
-
-```
-/ship:shape auth
-```
-
-Shape le package "auth" spécifiquement.
-
-## Output
-
-Le package sera planifié dans `.ship/packages/<nom-package>/` avec :
-- `package.md` : Vision, scopes, truths, artifacts, key links
-- `verification.md` : Critères de vérification par scope
-
-## Exemples
-
-```
-/ship:shape
-```
-
-Lance le shaping. Si le mapping contient plusieurs packages, l'agent demande lequel shaper.
-
-```
-/ship:shape dashboard
-```
-
-Shape directement le package "dashboard".
+---
+name: ship:shape
+description: "Lance le shaping d'un package en scopes indépendants"
+---
+
+# Commande shape
+
+Lance l'agent ship-shaper pour planifier UN package en scopes indépendants avec critères de vérification.
+
+## 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-shaper` en utilisant le tool Task avec les paramètres suivants:
+
+```
+subagent_type: ship-shaper
+prompt: "Le chemin du projet est {projectPath}. [Le nom du package à shaper ou 'Demande quel package shaper']"
+```
+
+## Prérequis
+
+Avant de lancer l'agent, vérifie que ces fichiers existent :
+
+| Fichier | Obligatoire | Créé par |
+|---------|-------------|----------|
+| `{projectPath}/packages/mapping.md` | Oui | splitter |
+| `{projectPath}/prd.md` | Oui | brainstormer-prd |
+| `{projectPath}/architecture.md` | Oui | architect |
+| `{projectPath}/requirements.md` | Oui | specifier |
+
+Si un fichier manque, indique à l'utilisateur quelle commande lancer :
+- Pas de mapping.md → `/ship:split`
+- Pas de prd.md → `/ship:prd`
+- Pas d'architecture.md → `/ship:architect`
+- Pas de requirements.md → `/ship:specify`
+
+## 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
+
+**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. **Vérifier les prérequis** : mapping.md, prd.md, architecture.md, requirements.md
+
+2. **Identifier le package** :
+   - Si un nom de package est fourni en argument → utiliser ce package
+   - Sinon → l'agent demandera lequel shaper
+
+3. **Lancer l'agent ship-shaper** qui va :
+   - Lire le mapping et les inputs globaux
+   - Extraire les exigences pertinentes
+   - Proposer un découpage en scopes (validation utilisateur)
+   - Définir les must-haves par scope
+   - Définir les critères de vérification
+   - Produire package.md et verification.md
+
+## Syntaxe
+
+```
+/ship:shape
+```
+
+Shape un package (l'agent demandera lequel si plusieurs dans le mapping).
+
+```
+/ship:shape auth
+```
+
+Shape le package "auth" spécifiquement.
+
+## Output
+
+Le package sera planifié dans `{projectPath}/packages/<nom-package>/` avec :
+- `package.md` : Vision, scopes, truths, artifacts, key links
+- `verification.md` : Critères de vérification par scope
+
+## Exemples
+
+```
+/ship:shape
+```
+
+Lance le shaping. Si le mapping contient plusieurs packages, l'agent demande lequel shaper.
+
+```
+/ship:shape dashboard
+```
+
+Shape directement le package "dashboard".

package/commands/ship/specify.md

@@ -9,19 +9,28 @@ Transforme un PRD existant en Software Requirements Specification (SRS) formel.
 
 ## 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-specifier` en utilisant le tool Task avec les parametres suivants:
 
 ```
 subagent_type: ship-specifier
-prompt: [Le contexte de l'utilisateur ou "Transforme le PRD en requirements"]
+prompt: "Le chemin du projet est {projectPath}. [Le contexte de l'utilisateur ou 'Transforme le PRD en requirements']"
 ```
 
 ## Prerequis
 
-Un PRD doit exister dans `.ship/prd.md`.
+Un PRD doit exister dans `{projectPath}/prd.md`.
 
 **Si aucun PRD n'existe** :
-> "Je ne trouve pas de PRD dans `.ship/prd.md`. Lance d'abord `/ship:prd` pour creer un PRD, puis reviens ici."
+> "Je ne trouve pas de PRD dans `{projectPath}/prd.md`. Lance d'abord `/ship:prd` pour creer un PRD, puis reviens ici."
 
 ## Comportement de relais (IMPORTANT)
 
@@ -45,13 +54,13 @@ Quand l'agent te retourne une question pour l'utilisateur :
 
 ## Comportement attendu
 
-1. Verifier que `.ship/prd.md` existe
+1. Verifier que `{projectPath}/prd.md` existe
 2. L'agent va:
    - Lire le PRD et la research (si presente)
    - Extraire les exigences fonctionnelles, non-fonctionnelles et contraintes
    - Poser des questions pour clarifier les ambiguites
    - Prioriser avec MoSCoW (Must/Should/Could/Won't)
-   - Produire un SRS structure dans `.ship/requirements.md`
+   - Produire un SRS structure dans `{projectPath}/requirements.md`
 
 ## Exemple d'utilisation
 
@@ -61,8 +70,8 @@ Quand l'agent te retourne une question pour l'utilisateur :
 
 ## Output
 
-**Fichier genere** :
-- `.ship/requirements.md` : Le Software Requirements Specification
+**Fichier genere** (dans le dossier projet) :
+- `requirements.md` : Le Software Requirements Specification
 
 **Structure du requirements.md** :
 - Meta (version, date, source, statut)

package/commands/ship/split.md

@@ -9,11 +9,20 @@ Decoupe le projet en packages livrables et cree le mapping exigences <-> package
 
 ## 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-splitter` en utilisant le tool Task avec les parametres suivants:
 
 ```
 subagent_type: ship-splitter
-prompt: [Le contexte de l'utilisateur ou "Decoupe le projet en packages livrables"]
+prompt: "Le chemin du projet est {projectPath}. [Le contexte de l'utilisateur ou 'Decoupe le projet en packages livrables']"
 ```
 
 ## Syntaxe
@@ -26,18 +35,18 @@ prompt: [Le contexte de l'utilisateur ou "Decoupe le projet en packages livrable
 
 Les fichiers suivants doivent exister :
 
-- `.ship/requirements.md` (obligatoire)
-- `.ship/architecture.md` (obligatoire)
-- `.ship/prd.md` (recommande)
+- `{projectPath}/requirements.md` (obligatoire)
+- `{projectPath}/architecture.md` (obligatoire)
+- `{projectPath}/prd.md` (recommande)
 
 **Si requirements.md n'existe pas** :
-> "Je ne trouve pas de requirements dans `.ship/requirements.md`. Lance d'abord `/ship:specify` pour creer les requirements, puis reviens ici."
+> "Je ne trouve pas de requirements dans `{projectPath}/requirements.md`. Lance d'abord `/ship:specify` pour creer les requirements, puis reviens ici."
 
 **Si architecture.md n'existe pas** :
-> "Je ne trouve pas d'architecture dans `.ship/architecture.md`. Lance d'abord `/ship:architect` pour definir l'architecture, puis reviens ici."
+> "Je ne trouve pas d'architecture dans `{projectPath}/architecture.md`. Lance d'abord `/ship:architect` pour definir l'architecture, puis reviens ici."
 
 **Si le PRD n'existe pas** :
-> "Note: Je ne trouve pas de PRD dans `.ship/prd.md`. Je vais travailler avec les requirements et l'architecture uniquement."
+> "Note: Je ne trouve pas de PRD dans `{projectPath}/prd.md`. Je vais travailler avec les requirements et l'architecture uniquement."
 
 ## Comportement de relais (IMPORTANT)
 
@@ -61,7 +70,7 @@ Quand l'agent te retourne une question pour l'utilisateur :
 
 ## Comportement attendu
 
-1. Verifier que `.ship/requirements.md` et `.ship/architecture.md` existent
+1. Verifier que `{projectPath}/requirements.md` et `{projectPath}/architecture.md` existent
 2. L'agent va:
    - Lire les requirements, architecture et PRD (si present)
    - Identifier les frontieres naturelles
@@ -70,7 +79,7 @@ Quand l'agent te retourne une question pour l'utilisateur :
    - Creer le mapping exigences <-> packages
    - Identifier les dependances entre packages
    - Suggerer l'ordre d'implementation
-   - Produire le mapping dans `.ship/packages/mapping.md`
+   - Produire le mapping dans `{projectPath}/packages/mapping.md`
 
 ## Exemple d'utilisation
 
@@ -80,8 +89,8 @@ Quand l'agent te retourne une question pour l'utilisateur :
 
 ## Output
 
-**Fichier genere** :
-- `.ship/packages/mapping.md` : Le document de mapping
+**Fichier genere** (dans le dossier projet) :
+- `packages/mapping.md` : Le document de mapping
 
 **Structure du mapping.md** :
 - Vue d'ensemble (nombre de packages, approche de decoupage)

package/commands/ship/status.md

@@ -1,129 +1,136 @@
----
-name: ship:status
-description: "Affiche l'état du projet ship et recommande l'étape suivante"
----
-
-# Commande status
-
-Affiche l'état actuel du projet ship et recommande la prochaine étape.
-
-## Instructions
-
-### Étape 1 : Vérifier les fichiers globaux
-
-Vérifie l'existence de chaque fichier dans l'ordre:
-
-1. `.ship/` - Le dossier ship existe-t-il?
-2. `.ship/brief.md` - Brief du projet (output brainstormer)
-3. `.ship/research.md` - Recherche domaine (optionnel)
-4. `.ship/prd.md` - Product Requirements Document
-5. `.ship/requirements.md` - Spécifications (SRS)
-6. `.ship/architecture.md` - Architecture technique
-7. `.ship/packages/mapping.md` - Mapping des packages
-
-### Étape 2 : Analyser les packages
-
-Si `mapping.md` existe, lire son contenu pour identifier les packages.
-
-Pour chaque package listé:
-1. Vérifier si le dossier `.ship/packages/<nom>/` existe
-2. Lire le front-matter de `package.md` pour obtenir le status et current_scope
-
-### Algorithme de détection
-
-```
-1. SI .ship/ n'existe pas
-   → État: "Non initialisé"
-   → Recommandation: /ship:brainstorm
-
-2. SI .ship/brief.md n'existe pas
-   → Recommandation: /ship:brainstorm
-
-3. SI .ship/prd.md n'existe pas
-   → Recommandation: /ship:prd
-
-4. SI .ship/requirements.md n'existe pas
-   → Recommandation: /ship:specify
-
-5. SI .ship/architecture.md n'existe pas
-   → Recommandation: /ship:architect
-
-6. SI .ship/packages/mapping.md n'existe pas
-   → Recommandation: /ship:split
-
-7. SINON analyser les packages par leur front-matter
-```
-
-### Front-matter des packages
-
-Format attendu dans `package.md`:
-
-```yaml
----
-status: pending | shaping | shaped | executing | executed | verifying | done
-current_scope: scope-1-auth-basic
----
-```
-
-### États possibles d'un package
-
-| Status | Description | Recommandation |
-|--------|-------------|----------------|
-| `pending` | Non commencé | /ship:shape <package> |
-| `shaping` | Shaping en cours | /ship:shape <package> |
-| `shaped` | Shape terminé | /ship:execute <package> |
-| `executing` | Exécution en cours | /ship:execute <package> |
-| `executed` | Exécution terminée | /ship:verify <package> |
-| `verifying` | Vérification en cours | /ship:verify <package> |
-| `done` | Package terminé | Passer au suivant |
-
-## Format de sortie
-
-```
-==========================================
-        SHIP STATUS - [Nom Projet]
-==========================================
-
-FICHIERS GLOBAUX
-----------------
-  [OK] brief.md          Brief du projet
-  [OK] research.md       Recherche domaine (optionnel)
-  [OK] prd.md            Product Requirements
-  [OK] requirements.md   Spécifications (SRS)
-  [OK] architecture.md   Architecture technique
-  [OK] packages/mapping.md   Mapping des packages
-
-PACKAGES (N)
-------------
-  [DONE]      auth           Scope 3/3 - Terminé
-  [EXECUTING] dashboard      Scope 2/5 - En cours: scope-2-widgets
-  [PENDING]   notifications  Scope 0/4 - Non commencé
-
-==========================================
-PROCHAINE ÉTAPE RECOMMANDÉE:
-  /ship:execute dashboard
-
-  Continuer l'implémentation du scope "scope-2-widgets"
-==========================================
-```
-
-## Recommandations contextualisées
-
-| Situation | Message |
-|-----------|---------|
-| Rien n'existe | "Lance `/ship:brainstorm` pour démarrer" |
-| Brief seul | "Lance `/ship:prd` pour créer le PRD" |
-| PRD présent | "Lance `/ship:specify` pour définir les exigences" |
-| Requirements présents | "Lance `/ship:architect` pour définir l'architecture" |
-| Architecture présente | "Lance `/ship:split` pour découper en packages" |
-| Mapping présent, aucun package shapé | "Lance `/ship:shape <premier-package>`" |
-| Package executing | "Continue avec `/ship:execute <package>` (scope: <name>)" |
-| Package executed | "Lance `/ship:verify <package>`" |
-| Vérification failed | "Corrige puis `/ship:execute <package>`" |
-| Tout done | "Tous les packages sont terminés!" |
-
-## Notes
-
-- Si un front-matter est absent ou malformé, considérer le package comme `pending`
-- Ne pas lister tous les fichiers, juste vérifier l'existence
-- Les messages doivent être clairs et actionnables
+---
+name: ship:status
+description: "Affiche l'état du projet ship et recommande l'étape suivante"
+---
+
+# Commande status
+
+Affiche l'état actuel du projet ship et recommande la prochaine étape.
+
+## 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/`
+
+### Étape 1 : Vérifier les fichiers globaux
+
+Vérifie l'existence de chaque fichier dans l'ordre:
+
+1. `{projectPath}/` - Le dossier projet existe-t-il?
+2. `{projectPath}/brief.md` - Brief du projet (output brainstormer)
+3. `{projectPath}/research.md` - Recherche domaine (optionnel)
+4. `{projectPath}/prd.md` - Product Requirements Document
+5. `{projectPath}/requirements.md` - Spécifications (SRS)
+6. `{projectPath}/architecture.md` - Architecture technique
+7. `{projectPath}/packages/mapping.md` - Mapping des packages
+
+### Étape 2 : Analyser les packages
+
+Si `mapping.md` existe, lire son contenu pour identifier les packages.
+
+Pour chaque package listé:
+1. Vérifier si le dossier `{projectPath}/packages/<nom>/` existe
+2. Lire le front-matter de `package.md` pour obtenir le status et current_scope
+
+### Algorithme de détection
+
+```
+1. SI {projectPath}/ n'existe pas
+   → État: "Non initialisé"
+   → Recommandation: /ship:brainstorm
+
+2. SI {projectPath}/brief.md n'existe pas
+   → Recommandation: /ship:brainstorm
+
+3. SI {projectPath}/prd.md n'existe pas
+   → Recommandation: /ship:prd
+
+4. SI {projectPath}/requirements.md n'existe pas
+   → Recommandation: /ship:specify
+
+5. SI {projectPath}/architecture.md n'existe pas
+   → Recommandation: /ship:architect
+
+6. SI {projectPath}/packages/mapping.md n'existe pas
+   → Recommandation: /ship:split
+
+7. SINON analyser les packages par leur front-matter
+```
+
+### Front-matter des packages
+
+Format attendu dans `package.md`:
+
+```yaml
+---
+status: pending | shaping | shaped | executing | executed | verifying | done
+current_scope: scope-1-auth-basic
+---
+```
+
+### États possibles d'un package
+
+| Status | Description | Recommandation |
+|--------|-------------|----------------|
+| `pending` | Non commencé | /ship:shape <package> |
+| `shaping` | Shaping en cours | /ship:shape <package> |
+| `shaped` | Shape terminé | /ship:execute <package> |
+| `executing` | Exécution en cours | /ship:execute <package> |
+| `executed` | Exécution terminée | /ship:verify <package> |
+| `verifying` | Vérification en cours | /ship:verify <package> |
+| `done` | Package terminé | Passer au suivant |
+
+## Format de sortie
+
+```
+==========================================
+        SHIP STATUS - [Nom Projet]
+==========================================
+
+FICHIERS GLOBAUX
+----------------
+  [OK] brief.md          Brief du projet
+  [OK] research.md       Recherche domaine (optionnel)
+  [OK] prd.md            Product Requirements
+  [OK] requirements.md   Spécifications (SRS)
+  [OK] architecture.md   Architecture technique
+  [OK] packages/mapping.md   Mapping des packages
+
+PACKAGES (N)
+------------
+  [DONE]      auth           Scope 3/3 - Terminé
+  [EXECUTING] dashboard      Scope 2/5 - En cours: scope-2-widgets
+  [PENDING]   notifications  Scope 0/4 - Non commencé
+
+==========================================
+PROCHAINE ÉTAPE RECOMMANDÉE:
+  /ship:execute dashboard
+
+  Continuer l'implémentation du scope "scope-2-widgets"
+==========================================
+```
+
+## Recommandations contextualisées
+
+| Situation | Message |
+|-----------|---------|
+| Rien n'existe | "Lance `/ship:brainstorm` pour démarrer" |
+| Brief seul | "Lance `/ship:prd` pour créer le PRD" |
+| PRD présent | "Lance `/ship:specify` pour définir les exigences" |
+| Requirements présents | "Lance `/ship:architect` pour définir l'architecture" |
+| Architecture présente | "Lance `/ship:split` pour découper en packages" |
+| Mapping présent, aucun package shapé | "Lance `/ship:shape <premier-package>`" |
+| Package executing | "Continue avec `/ship:execute <package>` (scope: <name>)" |
+| Package executed | "Lance `/ship:verify <package>`" |
+| Vérification failed | "Corrige puis `/ship:execute <package>`" |
+| Tout done | "Tous les packages sont terminés!" |
+
+## Notes
+
+- Si un front-matter est absent ou malformé, considérer le package comme `pending`
+- Ne pas lister tous les fichiers, juste vérifier l'existence
+- Les messages doivent être clairs et actionnables