Étape 4 · Construire
/pulse:spirc
Enchaîner tout le travail d'une user story (spirc = Spécifier, Planifier, Implémenter, Relire, Commiter) : des assistants indépendants explorent, codent, relisent et vérifient ; je m'arrête pour votre accord et vous testez chaque tâche ; la spec et le plan s'écrivent d'abord s'ils manquent.
Description
« spirc » veut dire Spécifier, Planifier, Implémenter (réaliser), Relire, Commiter (enregistrer). Une seule commande mène une user story de bout en bout. S'il manque la spec ou le plan, elle les écrit d'abord, avec vous ; puis elle réalise les tâches une à une.
Pulse fait travailler des assistants spécialisés, chacun dans son rôle : l'un explore, l'un réalise, d'autres relisent et vérifient sans avoir écrit le code. Pulse s'arrête pour votre accord sur le plan, et c'est vous qui testez chaque tâche avant qu'elle soit enregistrée. En mode autonome, vous testez toutes les tâches ensemble, à la fin.
Vous pouvez aussi lui confier une demande précise : « ajouter un filtre par date », « le bouton Supprimer ne marche pas ». Elle devient une nouvelle tâche du plan, montrée pour votre accord avant d'être réalisée, ou une nouvelle US si c'est un nouveau besoin.
Pourquoi l'utiliser
- Une US de bout en bout, en une commande. Spec, plan, réalisation, relecture et enregistrement s'enchaînent ; vous n'avez pas à retenir l'ordre.
- Un regard extérieur à chaque tâche. Ceux qui relisent et vérifient n'ont pas écrit le code : ils repèrent les oublis.
- Vous gardez la main. Le plan, les questions sur votre besoin, les actions à la main et les tests restent à vous, même en mode autonome (vos tests sont alors regroupés à la fin).
- Une demande précise trouve sa place. Correction, nouvelle tâche, nouvelle US ou idée notée pour plus tard : Pulse la range au bon endroit.
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:us: la spec et le plan s'écrivent en chemin. Ou après/pulse:plan: la réalisation commence tout de suite. - Après un enregistrement, quand il reste des tâches : c'est l'étape que Pulse propose le plus souvent.
- Pour une demande ponctuelle sur une US : une correction ou un petit ajout.
- Pour toute la première version :
/pulse:spirc versionprépare avec vous les specs et les plans de toutes les US Indispensables, puis les réalise à la suite, sans vous déranger. - Pour reprendre après une pause ou un
/clear: relancez/pulse:spirc US-001, la commande reprend à l'étape où elle s'était arrêtée.
Comment la lancer
/pulse:spirc <US-XXX> [T3 | "une demande"] (sans tâche ni demande : tout le plan de l'US) | <US-XXX US-YYY…> | version
Entre crochets [ ] : facultatif. Entre chevrons < > : à remplacer par votre valeur. La barre | sépare les choix possibles.
- L'US : celle dont vous réalisez le plan, par exemple
US-001. Absente, Pulse liste les plans et propose aussi « Spécifier et planifier une autre US ». - Plusieurs US (
US-001 US-003) ouversion(toutes les US Indispensables encore à faire) : une série. Pulse prépare d'abord avec vous la spec et le plan de chacune ; puis il les réalise à la suite, en mode autonome. Une question qui vous revient met seulement sa tâche en pause : les autres tâches avancent, puis les autres US quand celle-ci ne peut plus avancer. Deux US qui ne touchent pas les mêmes fichiers peuvent avancer en même temps, chacune dans un dossier à part, si vous l'acceptez. À votre retour : les questions mises de côté, en une fois, puis un test par US. - La portée (facultative) :
- rien : toutes les tâches restantes du plan, dans l'ordre ;
T3: seulement cette tâche ;"une demande"entre guillemets : un seul changement, cadré puis ajouté au plan.
- Les raccourcis (facultatifs), placés avant l'US et regroupables (
-axw) :-a: autonome. Les tâches s'enchaînent, les corrections se font seules, et vous testez tout à la fin, en un seul parcours. Une question sur votre besoin n'arrête que sa tâche : elle est mise « en pause », les autres tâches continuent, et toutes les questions vous sont posées ensemble. Les petits choix sont tranchés par Pulse et notés pour que vous les relisiez. Voir Laisser Pulse travailler seul.-f: rapide. L'essentiel des tests, les tâches s'enchaînent, une seule relecture et une seule vérification pour toute l'US, puis vous testez toute l'US à la fin avec une seule fiche. Sans ce raccourci, la question « rapide ou complet » vous est posée au début (sauf après/pulse:nouveau, qui règle déjà le rythme sur rapide).-d: devant vous. Chaque tâche est réalisée dans la conversation, sous vos yeux ; la relecture et la vérification restent faites par des assistants qui n'ont pas écrit le code. Ce raccourci n'est pas une question du début : il se donne d'avance. Avec-aou-f, Pulse vous demande lequel garder.-t: tests d'abord. Les tests de chaque tâche sont écrits avant son code.-x: un contrôle de sécurité en plus, à chaque tâche.-w: dans un dossier à part, sur sa propre branche.
Sans raccourci, Pulse vous pose dès le début une seule série de questions : le rythme (« Rapide » ou « Complet »), les options à cocher (enchaîner les tâches sans arrêt, un contrôle de sécurité à chaque tâche, un dossier à part), les tests si vous prenez « Complet », et la façon d'envoyer le travail.
/pulse:spirc US-001
/pulse:spirc -a US-001
/pulse:spirc US-002 "le bouton Supprimer ne marche pas"
/pulse:spirc version
Ce qu'elle produit
| Fichier | Ce qui change |
|---|---|
aidd_docs/tasks/<groupe>/SPEC-US-XXX-<nom>.md | La spec, si elle manquait. |
aidd_docs/tasks/<groupe>/PLAN-SPEC-US-XXX-<nom>.md | Le plan, s'il manquait ; puis les tâches cochées une à une, et le journal (plan validé, chaque enregistrement). |
| Les fichiers de chaque tâche | Le code de l'appli. |
aidd_docs/tasks/<groupe>/revues/… | Un rapport de relecture par tâche ; en rythme rapide, un seul pour toute l'US. |
| Le plan, sections « Questions en attente » et « Choix faits par Pulse » | En mode autonome : les questions qui vous attendent et les petits choix faits par Pulse, à relire au test groupé. |
aidd_docs/captures/US-XXX/ | Les captures d'écran gardées comme preuves par la vérification, sur votre ordinateur seulement ; effacées quand l'US est envoyée. |
docs/user-stories.md, US-XXX-<nom>.md | Pour une demande qui est un nouveau besoin : la nouvelle US. |
docs/prd.md | Une idée hors du périmètre, notée « En attente ». |
docs/technical.md | Les choix techniques, s'ils n'étaient pas encore faits. |
docs/lexique.md, aidd_docs/memory/ | La notion du jour, et ce que la mémoire doit retenir (après votre accord). |
S'y ajoute une version enregistrée dans Git par tâche, envoyée selon le choix noté dans le plan.
Risques et précautions
- En mode autonome, vos décisions attendent dans le plan. Une question sur votre besoin ou le périmètre, une action à faire à la main ou un problème qui résiste aux corrections met seulement sa tâche en pause ; les autres avancent. Pulse s'arrête une seule fois, quand plus rien ne peut avancer, et vous pose toutes ses questions ensemble. Restent aussi des arrêts : la validation d'un plan qui vient d'être écrit, le choix de l'envoi et la mise en ligne.
- Chaque tâche est contrôlée sans vous. Quand un assistant rend la main, Pulse vérifie les règles du projet, les clés secrètes et les contrôles rapides sur ce qu'il vient d'écrire. En rythme complet, toute la suite de tests sans navigateur tourne avant l'enregistrement de chaque tâche, et le rapport porte la ligne « Filet anti-régression : N tests, tous verts ». Les tests qui ouvrent le site dans un navigateur tournent une fois, à la fin de l'US : au test groupé en mode autonome, sinon juste avant le récapitulatif.
- Une longue réalisation se reprend sans perdre le fil. Après la limite d'utilisation ou un résumé automatique de la conversation, Pulse relit l'état dans le plan. Une notification du bureau peut vous prévenir quand il vous attend ; la notification et la reprise automatique à la limite d'utilisation sont prévues pour Claude Code dans un terminal ; dans l'extension VS Code, elles ne sont pas confirmées (voir Laisser Pulse travailler seul).
- En mode autonome, l'envoi attend votre test. Les versions restent sur votre ordinateur jusqu'à la fin du test groupé.
- Claude Code vous demande votre accord pour lancer l'application et l'essayer, et pour envoyer le travail sur le dépôt en ligne.
Problèmes et solutions
Une tâche reste « en pause : votre décision »
Une question vous attend dans la section « Questions en attente » du plan. Pulse vous la pose quand plus aucune autre tâche ne peut avancer, ou à la fin. Pour voir combien il y en a tout de suite, lancez /pulse:status.
Pulse attend mes réponses avant d'écrire le plan
La spec a encore des questions ouvertes. Le plan attend vos réponses, même en mode autonome : c'est votre besoin qui fixe ce qui sera construit.
Pulse me demande de choisir les outils
Les choix techniques ne sont pas encore faits. Pulse applique d'abord l'étape de /pulse:tech, même en mode autonome : ce choix vous appartient.
« Il manque le PRD »
La commande a besoin de savoir ce qui fait partie de la première version. Lancez /pulse:prd, ou /pulse:brainstorm si vous n'avez pas encore de brief.
La boucle propose /pulse:get-help
Un problème grave persiste après deux corrections. Pas à pas, la boucle s'arrête là. En mode autonome, la tâche se met en pause et la question « Demander de l'aide » vous attend avec les autres ; les tâches qui n'en dépendent pas avancent. Pulse s'arrête aussi tout de suite si le travail mis de côté d'une tâche ne se remet pas en place. Dans tous les cas, la tâche reste en cours et /pulse:get-help prépare une demande d'aide prête à envoyer, sans vos secrets.
Le garde-fou contre les clés secrètes s'est déclenché
C'est une protection : une clé allait finir dans le code ou dans une version. Pulse vous explique, corrige, puis reprend l'étape en cours.
Exemples
/pulse:spirc US-001
Comment réaliser cette user story ? → Complet Quelles options voulez-vous ? → aucune cochée Si vous choisissez Complet, quels tests ? → Tests d'abord (Recommandé) Comment envoyer le travail ? → Directement sur la version principale
Je fais travailler des assistants spécialisés : l'un réalise, d'autres relisent et vérifient sans avoir écrit le code. C'est vous qui testez chaque tâche. Plan de US-001 : ✅ T1 · ✅ T2 · ⬜ T3 – Afficher les créneaux libres · ⬜ T4 – Confirmer le rendez-vous. Le plan vous convient ? On commence la réalisation ?
Oui
T3 – Afficher les créneaux libres. Ce qui va être fait : calculer et afficher les créneaux libres de la journée.
Relecture : ✅ Validé. 🧪 À vous de tester : votre fiche SMOKE-TEST-US-001-T3-afficher-les-creneaux-libres.md (3 étapes, environ 3 minutes). L'application est ouverte : tapez http://localhost:3000 dans votre navigateur. Étape 1 : cliquez sur « Prendre rendez-vous » ; le créneau de 10 h, déjà réservé, n'apparaît pas. Le test est-il concluant ?
Oui, tout fonctionne
git commit -m "feat(T3): affiche les créneaux libres de la journée"
T3 ✅ terminée · US-001 : 3/4 Continuer avec T4 – Confirmer le rendez-vous ?
/pulse:spirc version
On prépare d'abord ces 3 user stories ensemble : leurs specs et leurs plans, que vous validez. Ensuite je les réalise à la suite, sans vous déranger. US-001 Prendre rendez-vous · US-002 Voir mes rendez-vous · US-003 Annuler un rendez-vous
Tout est prêt : 3 user stories, 8 tâches. Je les réalise maintenant, à la suite. Laissez cette fenêtre ouverte ; je vous appelle quand c'est fini, ou si une décision vous revient.
US-001 ✅ prête à tester · US-002 ✅ prête à tester · US-003 ⏸ une question Un rendez-vous annulé la veille doit-il prévenir le client par e-mail ?
Oui
US-003 ✅ prête à tester. On passe aux tests : votre fiche pour US-001 (5 étapes, environ 5 minutes).
/pulse:spirc US-002 "le bouton Supprimer ne marche pas"
J'ai fait rassembler les faits : la suppression d'un rendez-vous est prévue par US-002. C'est une correction. Tâche ajoutée au plan : T9 – Supprimer un rendez-vous de la liste du jour. Critères : le rendez-vous disparaît de la liste ; le créneau redevient libre. Le plan vous convient ? On commence la réalisation ?
Oui
Commandes liées
/pulse:specet/pulse:plan: les deux premières étapes, appliquées pour vous si elles manquent./pulse:implement: réaliser une tâche précise, pas à pas./pulse:refine: ajuster le plan avant la réalisation./pulse:deploy: mettre en ligne une fois la première version terminée./pulse:security: un contrôle complet de la sécurité de votre appli.