Étape 3 · Préparer

`/pulse:guide`

Produire le guide de réalisation pas à pas (docs/guide/) à partir du plan : pour chaque tâche, dans l'ordre, les commandes à copier-coller, ce qu'il faut vérifier et les actions manuelles.

Description

/pulse:guide vous donne votre carnet de route. Une page d'accueil, docs/guide/index.md, dit où en est le projet, quelle commande lancer ensuite, où en est la première version et quoi faire en cas de blocage. Puis une page par plan liste, pour chaque tâche et dans l'ordre, les commandes à copier-coller dans Claude Code.

Sur chaque page, les commandes 🔵 sont obligatoires et les ⚪ facultatives. Le signe ⚠️ marque une action à faire vous-même (saisir une clé chez l'hébergeur, par exemple) ou un prérequis. Vous savez aussi ce qu'il faudra vérifier à chaque tâche.

Le guide se fabrique entièrement à partir de vos plans, et se met à jour tout seul chaque fois qu'un plan change. La commande le refait, vérifie qu'il colle à l'état réel du projet, puis vous présente la prochaine commande à copier.

Première version : 1 US terminée sur 3
US en cours : US-002 – Liste des rendez-vous du jour (2 tâches sur 4)

➡️ Prochaine commande à copier :
   /pulse:spirc US-002

⚠️ À prévoir pour US-003 : saisir la clé du service d'e-mails chez l'hébergeur

Ce que /pulse:guide vous présente, en quelques lignes.

Pourquoi l'utiliser

Vous avancez seul, dans l'ordre. Chaque ligne du guide est une commande à copier dans Claude Code.
Il est toujours à jour. Dès qu'un plan change (avec /pulse:plan, /pulse:commit ou /pulse:refine), le guide se refait en silence.
Les actions à la main ne vous surprennent pas. Elles sont marquées ⚠️ à l'avance, avec la tâche qui en a besoin.
Les décalages sont repérés. Une tâche notée « en cours » sans aucun changement, ou une tâche déjà faite mais pas cochée : Pulse vous le signale.

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:plan : le guide existe déjà ; lancez la commande pour le lire et voir la prochaine étape.
Quand vous ne savez plus quelle commande taper.
Avant une séance de travail, pour voir les actions à la main à prévoir.
La première fois, avec expliquer, pour comprendre le rôle de chaque commande et l'ordre : réaliser, puis relire et tester, puis enregistrer.

Comment la lancer

/pulse:guide [expliquer]

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

Sans argument : Pulse met le guide à jour, puis vous présente la progression, la prochaine commande à copier et les actions à la main à prévoir.
expliquer : Pulse parcourt avec vous la page du plan en cours, une tâche à la fois. Pour chaque commande, il dit ce qu'elle fait et pourquoi elle vient à ce moment.

/pulse:guide

/pulse:guide expliquer

Ce qu'elle produit

Fichier	À quoi il sert
`docs/guide/index.md`	L'accueil du carnet : où en est le projet, la prochaine commande, les étapes avant le plan, les plans par groupe de user stories, l'avancement de la première version, quoi faire en cas de blocage.
`docs/guide/<groupe>/US-XXX-<nom>.md`	Une page par plan : pour chaque tâche, les commandes à copier (🔵 obligatoires, ⚪ facultatives), les actions à la main et prérequis (⚠️), ce qu'il faudra vérifier.

La commande lit vos plans, vos documents et votre code sans les modifier. Seule exception : remettre un plan au bon format, avec votre accord.

Risques et précautions

Votre projet n'est pas modifié. La commande écrit seulement dans docs/guide/.
Un plan au mauvais format se remet au format seulement avec votre accord, en gardant le contenu des tâches intact.
C'est vous qui lancez chaque commande. Le guide se copie-colle : rien ne part tout seul.

Problèmes et solutions

« Plan absent ou non reconnu »

Le plan signalé n'a pas le format attendu : une tâche par ligne, sous le titre « Tâches », et une ligne « Priorité ». Pulse vous propose de le remettre au format, en gardant le contenu des tâches, puis relance le guide.

Pulse dit qu'il n'y a encore aucun plan

Le guide part des plans. Lancez /pulse:plan, ou /pulse:init pour retrouver la bonne étape.

Le guide indique une tâche « en cours » à laquelle je n'ai pas touché

Le plan ne colle plus à la réalité du projet. Pulse vous le signale : corrigez le plan avec /pulse:refine.

Une action à faire moi-même semble manquer

Par exemple appliquer la structure des données dans la console du fournisseur, ou saisir une variable chez l'hébergeur. Pulse la signale ; ajoutez-la au plan avec /pulse:refine.

Exemples

/pulse:guide

pulse-aidd guide

Votre carnet de route est à jour. Première version : US-001 (prise de rendez-vous) terminée · US-002 (liste des rendez-vous du jour) : 2 tâches sur 4. ➡️ Prochaine commande à copier : /pulse:spirc US-002 ⚠️ À prévoir pour US-003 : créer un compte chez le service d'e-mails et saisir sa clé chez l'hébergeur.

/pulse:guide expliquer

Voici la page de US-002, tâche T7 – Afficher les rendez-vous du jour. 🔵 /pulse:implement US-002 T7 : réalise la tâche et vous l'explique. 🔵 /pulse:review T7 : deux assistants relisent et essaient la tâche, puis vous la testez. 🔵 /pulse:commit : enregistre la version. Pourquoi cet ordre : on réalise, on vérifie, puis on enregistre seulement ce qui marche. On passe à la tâche suivante ?

Oui

Commandes liées

/pulse:plan : écrit les plans dont le guide est tiré.
/pulse:refine : corrige un plan qui ne colle plus à la réalité.
/pulse:status : savoir où vous en êtes sur tout le projet, sans rien lancer.
/pulse:spirc : la commande la plus souvent proposée pour réaliser un plan.
/pulse:init : retrouver la bonne étape quand il n'y a pas encore de plan.