Étape 3 · Préparer

/pulse:refine

Ajuster le plan à partir des questions ou remarques de la personne : répondre à chaque point, modifier les tâches concernées en respectant les règles du plan, montrer ce qui change, puis faire valider.

    Description

    Votre plan est prêt, mais une tâche vous paraît floue, l'ordre ne vous convient pas, ou vous avez simplement une question. /pulse:refine répond à chacune de vos remarques, puis ajuste le plan en gardant ses règles : des tâches petites, visibles et testables en moins de 2 minutes.

    Chaque remarque est d'abord classée : une simple question (le plan reste tel quel), un changement d'ordre ou de découpage, un ajout au périmètre, un souci technique ou une exigence oubliée. Selon le cas, le changement se fait dans le plan, ou d'abord dans le PRD ou les choix techniques. Une fonctionnalité en plus ou une exigence oubliée devient une nouvelle US : Pulse vous propose de l'écrire avec /pulse:spec "…", qui la vérifie et vous la fait valider.

    Rien n'est écrit avant votre accord. Pulse vous montre un tableau de vos remarques, puis la liste de ce qui change (✏️ modifié, ➕ ajouté, ➖ déplacé). Sa règle : « Le plan est à vous : on peut le changer, à condition de savoir ce que ça change. »

    ## Ajustement du plan

| Remarque                  | Réponse                      | Changement        |
|---------------------------|------------------------------|-------------------|
| Voir les créneaux d'abord | Oui : T3 ne dépend pas de T2 | T3 passe avant T2 |

### Ce qui change dans PLAN-SPEC-US-001-prise-de-rendez-vous.md
- ✏️ T3 – Afficher les créneaux libres → placée avant T2

### Ailleurs
- docs/prd.md : rien
- US-001-prise-de-rendez-vous.md : rien
- docs/user-stories.md : rien
- Nouvelle US à écrire ensuite : aucune

Questions restantes : aucune

    La proposition que /pulse:refine vous montre avant de toucher au plan.

    Pourquoi l'utiliser

    • Vos questions ont une vraie réponse. Chaque réponse donne sa raison : la priorité, l'ordre imposé entre deux tâches, la sécurité.
    • Vous voyez avant d'accepter. Le tableau des changements s'affiche avant toute écriture. Vous pouvez appliquer, modifier la proposition ou garder le plan actuel.
    • Le plan reste solide. Une tâche nouvelle ou modifiée suit les règles du plan : testable en moins de 2 minutes, 3 fichiers et 3 critères au plus.
    • Le travail déjà fait est protégé. Une tâche terminée reste telle quelle : un changement devient une nouvelle tâche.

    Quand l'utiliser

    1. 1 Démarrer
    2. 2 Décrire
    3. 3 Préparer
    4. 4 Construire
    5. 5 Mettre en ligne
    6. 6 Être trouvé
    7. 7 À tout moment
    • Juste après /pulse:plan, quand une tâche vous paraît floue, de trop, mal placée, ou qu'il en manque une.
    • Pendant la réalisation, si vous changez d'avis. La tâche en cours se modifie seulement avec votre accord explicite.
    • Pour comprendre un choix du plan : posez votre question, le plan reste tel quel.
    • Pour changer la façon d'envoyer le travail : la ligne « Envoi » du plan (version parallèle, branche principale ou en local) se change ici, à votre demande.

    Comment la lancer

    /pulse:refine [<US-XXX>] "vos questions ou remarques sur le plan"

    Entre crochets [ ] : facultatif. Entre chevrons < > : à remplacer par votre valeur. La barre | sépare les choix possibles.

    • L'US (facultative) : celle dont vous ajustez le plan, par exemple US-001. Sans elle, Pulse vous demande quel plan, en proposant d'abord celui qui a une tâche en cours. S'il n'y a aucun plan, il vous propose /pulse:plan.
    • Vos remarques, entre guillemets : des questions ou des changements, plusieurs à la fois si vous voulez. Sans remarque, Pulse demande « Qu'aimeriez-vous changer dans le plan ? », avec des réponses types : une tâche est floue, changer l'ordre, ajouter quelque chose, une tâche est de trop.
    /pulse:refine US-001 "Je veux voir les créneaux libres avant le formulaire"
    /pulse:refine US-001 "Pourquoi le rappel par e-mail n'est pas dans ce plan ?"
    /pulse:refine

    Ce qu'elle produit

    Seuls les fichiers concernés par vos remarques changent, après votre accord :

    FichierCe qui change
    aidd_docs/tasks/<groupe>/PLAN-SPEC-US-XXX-<nom>.mdLe plan : tâches modifiées, ajoutées ou déplacées, et une ligne « plan modifié » dans son journal.
    docs/prd.mdSeulement pour un changement de périmètre : une fonctionnalité ajoutée à la première version, ou reportée. La nouvelle US s'écrit ensuite avec /pulse:spec "…".
    US-XXX-<nom>.mdUn critère d'acceptation ajouté, quand l'exigence oubliée relève d'une autre US.
    docs/user-stories.mdUne priorité changée.
    aidd_docs/memory/project.mdUne décision durable (par exemple « pas de compte client dans la première version »), si vous acceptez de la noter.
    docs/guide/Votre carnet de route, mis à jour tout seul.

    Risques et précautions

    • Rien n'est écrit sans votre accord. Trois choix vous sont proposés : « Appliquer ces changements », « Modifier la proposition » ou « Garder le plan actuel ».
    • Le travail fait reste en place. Une tâche terminée ne change pas. La tâche en cours se modifie seulement avec votre accord, et Pulse vous signale le code déjà écrit.
    • Une spec validée reste telle quelle. Une exigence oubliée devient alors une nouvelle US, avec sa spec et son plan, écrite avec /pulse:spec.
    • Les numéros des tâches ne changent jamais. Une nouvelle tâche prend le numéro qui suit, même si elle se place plus tôt dans l'ordre.
    • Le plan, le PRD et la priorité des user stories s'écrivent seulement après votre accord à « Appliquer ces changements », sans autre demande ; le lexique se complète au fil des explications.

    Problèmes et solutions

    « Aucun plan trouvé »

    Il faut un plan à ajuster. Lancez d'abord /pulse:plan US-001, puis revenez avec vos remarques.

    J'ai oublié une exigence, mais la spec est « verrouillée »

    Une spec validée ne bouge plus : c'est elle qui fixe ce qui est construit. Votre exigence devient une nouvelle US, lancée avec /pulse:spec "…", avec sa propre spec et son propre plan.

    Pulse refuse de modifier une tâche terminée

    Elle est déjà enregistrée dans l'historique. Le changement que vous voulez devient une nouvelle tâche, ajoutée au plan.

    La nouvelle tâche porte un numéro inattendu (T9, placée en troisième)

    C'est normal : chaque numéro est unique sur tous vos plans. Seule la position dans la liste compte pour l'ordre de réalisation.

    Ma remarque remet en cause un outil choisi

    Si le changement touche la pile retenue, Pulse vous propose /pulse:tech pour revoir ce choix, avant de modifier le plan.

    Exemples

    /pulse:refine US-001 "Je veux voir les créneaux libres avant le formulaire"

    C'est possible : l'affichage des créneaux (T3) ne dépend pas du formulaire (T2). Ce qui change dans le plan : ✏️ T3 – Afficher les créneaux libres → placée avant T2. Ailleurs : rien. Appliquer ces changements (Recommandé) / Modifier la proposition / Garder le plan actuel ?

    Appliquer ces changements

    pulse-aidd guide

    Le plan est à jour, et son journal note « plan modifié ». ➡️ Prochaine étape : /pulse:spirc US-001, pour réaliser les tâches dans le nouvel ordre.

    /pulse:refine US-001 "Pourquoi le rappel par e-mail n'est pas dans ce plan ?"

    Le rappel par e-mail est une autre user story, US-003. Un plan couvre une seule US : le rappel aura son propre plan. Dans le PRD, il est classé « Essentiel » : il viendra après la première version. Le plan reste tel quel. Si vous voulez le rappel dès la première version, c'est un changement de périmètre : je modifierai d'abord le PRD, après votre accord.

    Commandes liées

    • /pulse:plan : écrit le plan que cette commande ajuste.
    • /pulse:spirc : réalise le plan ajusté, tâche par tâche.
    • /pulse:implement : réalise une tâche précise du plan, pas à pas.
    • /pulse:spec : décrit une exigence oubliée comme une nouvelle US.
    • /pulse:guide : votre carnet de route, mis à jour à chaque changement du plan.