naiersaidane/claude-mastery/planifie

/planifie

Découpe un PRD en phases indépendamment livrables par tranches verticales (tracer bullets). Sortie dans docs/PLAN.md.

Process

1. Récupère le PRD

Par défaut, lis docs/PRD.md. Si un chemin de fichier est passé en argument, lis-le. Si rien d'utilisable, demande à l'utilisateur de pointer le fichier ou de coller le contenu.

2. Mode extension si PLAN existe

Si docs/PLAN.md existe déjà, lis-le. Repère les user stories du PRD non couvertes par une phase existante et les incohérences avec un PRD qui a bougé. Ne réécris pas les phases déjà validées ; propose des phases additionnelles ou des extensions ciblées, et signale les contradictions à l'utilisateur avant d'écrire.

3. Explore le codebase

Si tu n'as pas déjà exploré le codebase, fais-le pour comprendre l'architecture actuelle, les patterns en place et les couches d'intégration. Si le projet est vierge (greenfield), saute cette étape.

4. Identifie les décisions architecturales durables

Avant de découper, identifie les décisions de haut niveau qui ne devraient pas bouger en cours d'implémentation :

• Structure des routes / patterns d'URL
• Forme du schéma de base de données
• Noms des modèles de données clés
• Approche d'authentification / autorisation
• Frontières des services tiers

Elles vont dans l'en-tête du plan, chaque phase peut s'y référer.

5. Drafte les tranches verticales

Découpe le PRD en phases tracer bullets. Chaque phase est une tranche fine qui traverse TOUTES les couches d'intégration de bout en bout, PAS une tranche horizontale d'une seule couche.

<règles-tranche-verticale>

• Chaque tranche livre un chemin étroit mais COMPLET à travers toutes les couches (schema, API, UI, tests)
• Une tranche terminée est démontrable ou vérifiable seule
• Préfère beaucoup de tranches fines à peu de tranches épaisses
• N'inclus PAS les noms de fichiers, noms de fonctions, ou détails d'implémentation susceptibles de changer
• INCLUS les décisions durables : routes, formes de schéma, noms de modèles

</règles-tranche-verticale>

6. Quiz l'utilisateur

Présente le découpage sous forme de liste numérotée. Pour chaque phase :

• Titre : nom court descriptif
• Bloquée par : autres tranches devant terminer d'abord
• User stories couvertes : numéros des user stories du PRD

Puis demande :

• La granularité est-elle bonne ? (trop grossière / trop fine)
• Les dépendances sont-elles correctes ?
• Des phases à fusionner ou découper davantage ?

Itère jusqu'à validation.

7. Écris le plan

Crée docs/ si absent. Écris docs/PLAN.md selon le template. En mode extension, intègre les phases additionnelles aux phases existantes sans toucher au contenu déjà validé. Confirme « ✓ écrit dans `docs/PLAN.md` ».

<plan-template>

Plan : <nom de la feature>

PRD source : <chemin ou identifiant>

Décisions architecturales

Décisions durables qui s'appliquent à toutes les phases :

• Routes : ...
• Schema : ...
• Modèles clés : ...
• (ajoute/retire des sections selon le contexte)

Phase 1 : <titre>

User stories : <liste depuis le PRD>

Ce qu'on livre

Description concise de cette tranche verticale. Décris le comportement de bout en bout, pas l'implémentation couche par couche.

Critères d'acceptation

• [ ] Critère 1
• [ ] Critère 2
• [ ] Critère 3

Bloquée par

• Référence à la phase bloquante (s'il y en a)

Ou « Aucune — démarrable immédiatement » s'il n'y a pas de bloqueur.

Phase 2 : <titre>

User stories : <liste depuis le PRD>

Ce qu'on livre

...

Critères d'acceptation

• [ ] ...

Bloquée par

• ...

<!-- Répéter pour chaque phase --> </plan-template>