Étape 3 · Préparer
/pulse:plan
Concevoir comment réaliser la spec d'une user story (pile, données, écrans, sécurité, fichiers), puis la découper en petites tâches ordonnées, chacune testable à l'écran (une spec = un plan, rangé à côté de sa spec), écrit une fois validé avec vous.
Description
Le plan décide comment construire ce que la spec demande, puis le découpe en petites tâches numérotées : T1, T2, T3… « On avance par petites tâches que vous pouvez tester une par une : l'IA se trompe moins, et vous gardez le contrôle. »
D'abord la conception : les outils utilisés, l'adresse de chaque écran, où sont gardées les informations et où l'on vérifie qui a le droit d'y toucher, les clés secrètes, les points de sécurité, les fichiers à créer. Ensuite les tâches : chacune livre quelque chose que vous pouvez voir et tester en moins de 2 minutes.
Le plan sert aussi de tableau de suivi : [ ] à faire, [~] en cours, [x] terminé. Une fois validé, Pulse écrit votre carnet de route, avec les commandes à copier tâche par tâche.
Conception : la pile de docs/technical.md · les rendez-vous gardés sur le serveur,
une cliente voit seulement les siens · aucun secret · fichiers : 4 à créer
- [ ] T1 – Afficher la page des créneaux, encore vide · US-001
- [ ] T2 – Réserver un créneau et le voir confirmé · US-001
- [ ] T3 – Refuser un créneau déjà pris · US-001
En parallèle avec : aucune
→ Valider le plan (Recommandé) / Je veux changer quelque choseLe plan présenté avant validation : la conception en quelques lignes, puis les titres des tâches.
Pourquoi l'utiliser
- Vous testez à chaque étape. Chaque tâche livre un résultat visible (une tâche tirée d'une recette du pack suit son découpage vérifié), du cas normal vers les cas d'erreur et les règles d'accès.
- La sécurité est pensée avant le code. Chaque règle importante est vérifiée côté serveur ; une protection exigée par la sécurité vous est expliquée.
- Vous savez ce qui vous revient. Une action à faire vous-même (créer un compte, saisir une clé) est signalée dans sa tâche.
- Un carnet de route toujours à jour.
docs/guide/index.mdvous dit quelle commande taper ensuite.
Quand l'utiliser
- 1 Démarrer
- 2 Décrire
- 3 Préparer
- 4 Construire
- 5 Mettre en ligne
- 6 Être trouvé
- 7 À tout moment
- Après
/pulse:spec, une fois la spec verrouillée. - Après
/pulse:ui maquettes, si vous avez maquetté les écrans : le plan cite la maquette retenue. - Avant
/pulse:implementou/pulse:spirc, qui réalisent les tâches.
Comment la lancer
/pulse:plan <US-XXX [US-YYY…] | chemin de la spec>Entre crochets [ ] : facultatif. Entre chevrons < > : à remplacer par votre valeur. La barre | sépare les choix possibles.
- Un numéro de user story (
US-001) : le plan de sa spec. - Plusieurs numéros : un plan par user story, l'un après l'autre, dans l'ordre du parcours.
- Le chemin d'une spec : le plan de cette spec.
- Sans rien : Pulse liste les specs, en premier celles qui attendent leur plan, et vous demande laquelle traiter.
/pulse:plan US-001/pulse:planCe qu'elle produit
| Fichier | À quoi il sert |
|---|---|
aidd_docs/tasks/<groupe>/PLAN-SPEC-US-XXX-<nom>.md | Le plan, à côté de sa spec : la conception technique, puis les tâches, chacune avec son objectif, ce dont elle dépend, ses fichiers, la vérification à faire à la main et les tests automatiques. |
docs/guide/ | Votre carnet de route : les commandes à copier, tâche par tâche. Il se met à jour tout seul. |
La ligne « En parallèle avec » des autres plans est mise à jour quand deux user stories peuvent avancer en même temps. Une fonctionnalité en plus, demandée pendant la validation, est notée « En attente » dans docs/prd.md.
Risques et précautions
- Cette commande écrit seulement des documents. Le code viendra avec la réalisation des tâches.
- Le plan compte seulement après votre validation. Pulse l'écrit d'abord « à valider », le vérifie, puis vous le montre ; il devient « validé » avec votre accord. Si vous demandez un changement, Pulse vous montre ce qui change, puis redemande.
- Pulse vérifie le plan avant de vous le montrer. Un outil contrôle que chaque critère de votre user story est vérifié par une tâche, que chaque test prévu par la spec a sa tâche, et que les tâches s'enchaînent bien. Ce qui reste à trancher vous est montré en une ligne, avec sa raison.
- La spec reste intacte. Le plan la lit sans la modifier ; un comportement qu'elle ne prévoit pas vous est présenté comme un ajout proposé.
- Un nouvel outil vous est demandé. Pulse en introduit un seulement avec votre accord. Un paiement s'intègre d'abord en mode test.
Problèmes et solutions
Pulse me propose de terminer la spec d'abord
La spec est absente, ou encore en brouillon avec des questions en suspens. Le plan s'appuie sur une spec verrouillée : lancez /pulse:spec US-001, puis revenez au plan.
Pulse me dit qu'il manque les choix techniques
Le plan a besoin de docs/technical.md pour savoir comment construire. Lancez /pulse:tech.
Le plan a trop de tâches
Pulse vise 1 à 4 tâches par user story. Au-delà, il le signale et propose de découper la user story en deux avec /pulse:us, puis une spec et un plan pour chacune.
Je veux ajouter une fonctionnalité au plan
C'est un changement de périmètre : Pulse la note « En attente » dans le PRD. Une fois le plan écrit, /pulse:refine l'ajoutera.
Pulse me dit que le plan attend ma validation
Le plan a été écrit et montré, mais pas encore accepté (la conversation s'est peut-être arrêtée). Relancez /pulse:plan US-001 : Pulse le vérifie de nouveau et vous le remontre.
Un plan existe déjà avec des tâches terminées
Pulse le garde tel quel, et vous propose seulement d'ajouter ou de réordonner les tâches restantes.
Exemples
/pulse:plan US-001
Conception : les rendez-vous sont gardés sur le serveur ; une cliente voit et modifie seulement les siens, vérifié côté serveur. Tâches : T1 Afficher la page des créneaux · T2 Réserver un créneau et le voir confirmé · T3 Refuser un créneau déjà pris. Ajout exigé par la sécurité : protéger le formulaire de réservation, ouvert à tous, contre les envois en masse. → Valider le plan (Recommandé) / Je veux changer quelque chose
Valider le plan
pulse-aidd guide
Votre carnet de route est dans docs/guide/index.md ; il se met à jour tout seul. Prochaine étape : /pulse:spirc US-001, ou /pulse:implement US-001 T1 pour la première tâche seulement.
/pulse:plan US-003
La spec du rappel par e-mail est encore en brouillon : une question reste ouverte. Je vous propose de la terminer d'abord avec /pulse:spec US-003.
Commandes liées
/pulse:spec: verrouiller la spec sur laquelle s'appuie le plan./pulse:ui: maquetter les écrans avant le plan./pulse:refine: changer le plan selon vos remarques./pulse:implement: réaliser une tâche et comprendre son code./pulse:spirc: enchaîner réalisation, relecture et enregistrement, tâche par tâche./pulse:guide: savoir quelle commande taper maintenant.