Étape 4 · Construire

`/pulse:implement`

Réaliser une tâche d'un plan et l'expliquer, en coulisse ou devant vous, au besoin dans un dossier à part ; pour enchaîner tout le plan, /pulse:spirc.

Description

/pulse:implement réalise une tâche du plan, puis vous l'explique : ce qui a changé, fichier par fichier, une notion de programmation tirée du code (« 💡 la notion du jour »), et les étapes pour la tester vous-même. La relecture et l'enregistrement viennent ensuite, avec /pulse:review puis /pulse:commit.

Sans numéro de tâche, elle vous propose de taper /pulse:spirc US-001, qui enchaîne tout le plan, ou de réaliser seulement la tâche suivante ici.

Au démarrage, une seule série de questions : Pulse code-t-il en coulisse (un assistant spécialisé code à part, la conversation reste légère) ou devant vous (vous voyez chaque étape) ? Faut-il écrire les tests d'abord, travailler dans un dossier à part, et comment envoyer le travail ? Avec le profil « Jamais programmé », Pulse prend les réglages conseillés et vous les annonce en une phrase.

T3 – Afficher les créneaux libres

Ce qui a changé
  creneaux.js        calcule les créneaux libres de la journée
  prise-rdv.html     affiche un bouton par créneau libre

💡 La notion du jour : la boucle (répéter une action pour chaque créneau)

🧪 À vous de tester
  1. Lancez l'appli, puis ouvrez l'adresse affichée
  2. Ouvrez « Prendre rendez-vous » : les créneaux de 9 h à 18 h s'affichent
  3. Un créneau déjà réservé n'apparaît pas

L'explication d'une tâche réalisée, telle que /pulse:implement la présente.

Au démarrage, vous choisissez si Pulse code en coulisse ou devant vous. Puis Pulse réalise la tâche, vérifie ses contrôles automatiques (deux essais au plus), vous l'explique et vous donne le test à faire. La relecture et l'enregistrement viennent ensuite, avec /pulse:review puis /pulse:commit.

Pourquoi l'utiliser

Une tâche à la fois. Chaque tâche est petite, testée et enregistrée seule : un problème se repère tout de suite.
Vous apprenez en chemin. À chaque tâche, une notion de programmation tirée de votre propre code, expliquée simplement et ajoutée à votre lexique.
Le code suit vos choix. Pulse code seulement ce que demande la tâche, avec les outils retenus, l'apparence choisie et vos maquettes. Une idée en plus est notée « En attente » dans le PRD, pour plus tard.
Tout le plan, quand vous le voulez. Sans numéro de tâche, Pulse vous propose /pulse:spirc, qui enchaîne réaliser, relire, tester, corriger et enregistrer, pour chaque tâche.

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 (et /pulse:refine si vous avez ajusté le plan).
Avec un numéro de tâche, pour avancer pas à pas : ensuite /pulse:review, puis /pulse:commit.
Sans numéro de tâche, pour être guidé vers /pulse:spirc, qui réalise tout le plan d'une US.
Pour reprendre une tâche en cours après une pause ou un /clear : relancez /pulse:implement US-001 T3. Pulse reprend la note de travail en cours si elle concerne cette tâche ; sinon il regarde où la tâche en est et vous propose la bonne suite (relecture, test ou enregistrement).
Dans une deuxième session Claude Code sur le même projet : Pulse le voit et vous propose un dossier à part.

Comment la lancer

/pulse:implement <US-XXX> <T3>

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 ou introuvable, Pulse liste les plans (en premier celui qui a une tâche en cours) et vous demande lequel.
La tâche : par exemple T3, la tâche réalisée. Sans elle, Pulse vous propose de taper /pulse:spirc pour tout le plan, ou de réaliser seulement la tâche suivante.
Les raccourcis (pour les habitués, facultatifs) : ils répondent d'avance aux questions du démarrage. Placez-les avant l'US ; ils se regroupent (-sw vaut -s -w).
- -s : en coulisse. Un assistant spécialisé code à part ; la conversation reste légère.
- -d : devant vous. Pratique pour apprendre en voyant chaque étape.
- -w : dans un dossier à part, sur sa propre branche. Utile quand une autre session travaille sur le même dossier.
- -t : tests d'abord. Un assistant écrit les tests de la tâche, on les voit échouer, puis le code doit les faire passer.
-s et -d ensemble se contredisent : Pulse vous demande lequel garder.

/pulse:implement US-001 T3

/pulse:implement -d US-001 T3

Ce qu'elle produit

Fichier ou dossier	Ce qui change
Les fichiers de la tâche	Le code, créé ou modifié à l'emplacement prévu par `docs/technical.md`.
`aidd_docs/tasks/<groupe>/PLAN-SPEC-US-XXX-<nom>.md`	Le plan : la tâche passe « en cours ». Elle sera « terminée » une fois relue et enregistrée.
`aidd_docs/tasks/<groupe>/SMOKE-TEST-US-XXX-…md`	La fiche de test de la tâche, pour l'essayer vous-même.
`docs/lexique.md`	La notion du jour, ajoutée à votre lexique.
`.env.example`	Le nom d'une nouvelle clé secrète, sans sa valeur.
`docs/prd.md`	Une idée hors de la tâche, notée « En attente ».
`aidd_docs/tasks/in-progress.md`	Une note de reprise, écrite à chaque arrêt pour vous et effacée dès votre réponse.

La tâche reste « en cours » : elle sera terminée après la relecture et l'enregistrement.

Risques et précautions

Vos clés secrètes restent chez vous. Vous les écrivez vous-même dans le fichier local prévu ; Pulse ajoute seulement leur nom dans .env.example.
Une bibliothèque s'ajoute seulement avec votre accord, avec une version fixée.
Les décisions vous reviennent. Dès qu'un choix apparaît, Pulse s'arrête et vous présente les options et leurs conséquences.
Claude Code vous demande votre accord pour lancer l'application et, plus tard, pour envoyer le travail sur le dépôt en ligne.

Problèmes et solutions

Pulse me propose d'abord /pulse:review et /pulse:commit

Des changements non enregistrés concernent une autre tâche. Une version enregistrée = une seule tâche : relisez et enregistrez d'abord celle-là, puis relancez la commande.

Pulse s'arrête sur la tâche

Il y a un blocage : une question sur votre besoin ou une action à faire vous-même (créer un compte, saisir une variable chez l'hébergeur). Répondez ou suivez les étapes données, puis Pulse reprend. Si un contrôle reste en échec après deux essais, il est signalé dans le rapport et Pulse vous propose /pulse:auto-fix.

Il reste beaucoup d'erreurs rouges après la tâche

Lancez /pulse:auto-fix : plusieurs assistants corrigent les erreurs des contrôles automatiques en même temps.

Pulse me demande de choisir les outils avant de coder

Il faut d'abord savoir avec quoi construire. Lancez /pulse:tech ; Pulse attend ce choix pour installer ou coder.

Pulse me renvoie vers /pulse:spirc pour une tâche « en pause »

Cette tâche attend votre réponse à une question notée dans la section « Questions en attente » du plan, pendant une réalisation autonome. Lancez /pulse:spirc US-XXX : Pulse vous pose la question, puis reprend la tâche.

J'ai fermé la conversation au milieu d'une tâche

Rien n'est perdu. Relancez /pulse:implement US-001 T3 : Pulse regarde où la tâche en est et reprend le code commencé, ou vous propose la bonne suite (relecture, votre test ou enregistrement). Pour reprendre tout le plan, tapez /pulse:spirc US-001.

Exemples

/pulse:implement US-001 T3

Je code en coulisse : un assistant spécialisé réalise la tâche à part, la conversation reste légère. T3 – Afficher les créneaux libres. Je vais : calculer les créneaux libres de la journée ; afficher un bouton par créneau. Fichiers concernés : creneaux.js, prise-rdv.html.

git diff --stat

Ce qui a changé : creneaux.js calcule les créneaux libres ; prise-rdv.html les affiche. 💡 La notion du jour : la boucle. Elle répète la même action pour chaque créneau de la journée. 🧪 À vous de tester : votre fiche SMOKE-TEST-US-001-T3-afficher-les-creneaux-libres.md (4 étapes, environ 3 minutes). L'application est ouverte : tapez http://localhost:3000 dans votre navigateur. Étape 1 : cliquez sur « Prendre rendez-vous », en haut de la page ; les créneaux de 9 h à 18 h s'affichent, sauf ceux déjà réservés. ➡️ Prochaine étape : /pulse:review, où deux assistants relisent la tâche et l'essaient.

/pulse:implement US-001

Pour enchaîner tout le plan (réaliser, relire, tester, enregistrer, tâche suivante), tapez /pulse:spirc US-001. Que préférez-vous : taper /pulse:spirc US-001 pour enchaîner tout le plan (recommandé), ou réaliser seulement T4 – Confirmer le rendez-vous ici ?

Commandes liées

/pulse:plan : découpe la spec en tâches, avant cette commande.
/pulse:review : la relecture et votre test, après une tâche réalisée.
/pulse:commit : enregistre la tâche relue et testée.
/pulse:spirc : enchaîne tout le plan (réaliser, relire, tester, enregistrer), avec en plus la spec et le plan s'ils manquent.
/pulse:auto-fix : corrige les erreurs rouges restantes.
/pulse:deploy : met en ligne une fois le plan terminé.