Étape 4 · Construire

`/pulse:review`

Relecture et vérification indépendantes d'une tâche (critères d'acceptation, sécurité, essai de l'application en marche), test manuel, puis corrections.

Description

/pulse:review fait examiner une tâche par deux assistants qui ne l'ont pas écrite. L'un relit le code : critères d'acceptation, sécurité, qualité. L'autre lance l'application et essaie chaque critère. « Un regard extérieur repère les oublis, et un essai en marche prouve que ça fonctionne ; votre test manuel le confirme ensuite. »

Vous recevez un verdict, le nombre de remarques par gravité (Critique, Haute, Moyenne, Basse) et les trois plus importantes, traduites en langage simple : ce que ça change pour vos clients. Puis c'est à vous : Pulse vous donne les étapes du test et vous demande s'il est concluant.

Enfin, Pulse corrige les remarques Critique, Haute et Moyenne, et les remarques Basse qui se confirment dans le code. Après chaque correction, une relecture de contrôle vérifie le résultat ; deux cycles de correction au plus.

Verdict : ⚠️ À corriger
Remarques : 0 Critique · 1 Haute · 1 Moyenne · 1 Basse

✅ Prouvé              Le rendez-vous choisi s'enregistre
🧪 À vérifier par vous  Le message de confirmation est lisible sur téléphone

Le plus important : un rendez-vous peut être pris à une date passée.

Le résumé présenté après l'examen d'une tâche.

Pourquoi l'utiliser

Un regard neuf. Ceux qui examinent n'ont pas écrit le code : ils voient ce que l'auteur ne voit plus.
La preuve que ça marche. L'application est lancée et chaque critère essayé, au-delà d'une simple lecture.
Votre test compte. Une tâche est prête seulement quand vous l'avez testée vous-même.
Des corrections ciblées. Les remarques sont triées par gravité, et chaque décision est notée dans le rapport.

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:implement US-001 T3, avant /pulse:commit.
Pour toute une US : chaque tâche en cours est examinée, puis vous la testez, une par une.
Pour tout le projet, avec tout : une relecture de l'ensemble par rapport à toutes les US terminées.
Pour reprendre : si la tâche a déjà un rapport, Pulse reprend là où vous en étiez (votre test, ou les corrections).

Comment la lancer

/pulse:review [T3 | <US-XXX> | tout]

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

T3 : cette tâche, cherchée dans tous les plans (chaque numéro est unique).
Une US (US-003) : toutes ses tâches en cours, examinées en même temps, avec un rapport et un test par tâche.
tout : l'ensemble du projet, par rapport à toutes les US terminées. Seule la relecture du code se fait ici ; l'essai en marche se fait tâche par tâche.
Rien : la tâche en cours. S'il n'y en a aucune, ou plusieurs, Pulse vous demande laquelle.

/pulse:review T3

/pulse:review US-001

/pulse:review tout

Ce qu'elle produit

Fichier	À quoi il sert
`aidd_docs/tasks/<groupe>/revues/PLAN-SPEC-US-XXX-<nom>/T3-<date>.md`	Le rapport de la tâche : verdict, remarques, résultat de l'essai en marche, votre test, et la suite donnée à chaque remarque.
`docs/revue-projet-<date>.md`	Avec `tout` : le rapport sur l'ensemble du projet.
`aidd_docs/captures/US-XXX/`	Les captures d'écran gardées comme preuves, avant et après une correction. Elles s'affichent dans le rapport et dans la fiche de test, restent sur cet ordinateur et sont effacées quand l'US est envoyée.
Les fichiers de la tâche	Les corrections, chacune expliquée en une ligne.

En rythme complet, le rapport porte aussi la ligne « Filet anti-régression : N tests, tous verts » : toute la suite de tests sans navigateur a tourné après la dernière modification. Quand la même remarque revient sur deux tâches d'une même user story et qu'elle peut se vérifier dans le code, Pulse vous propose d'en faire une règle contrôlée, avec votre accord.

La tâche n'est pas enregistrée ici : une fois le verdict validé et votre test concluant, elle est prête pour /pulse:commit.

Risques et précautions

Pour essayer l'application, un assistant la démarre puis l'arrête. Claude Code vous demande votre accord : Pulse vous l'annonce d'avance.
Vous choisissez quoi corriger. Pulse propose « Corriger Critique, Haute, Moyenne et les Basses retenues (Recommandé) », « Seulement les Critiques » ou « Je regarde d'abord ».
Accepter une réserve est possible. Si vous acceptez un point ⚠️ sans correction, c'est noté dans le rapport.

Problèmes et solutions

« Il n'y a rien à relire »

Aucun changement ni tâche en cours. Réalisez d'abord une tâche avec /pulse:implement US-001 T3, ou tapez /pulse:spirc US-001 pour enchaîner tout le plan.

Je ne sais pas comment tester

Suivez les étapes données par Pulse : elles commencent par ce que l'assistant n'a pas pu prouver seul, et indiquent comment ouvrir l'appli sur votre ordinateur.

Mon test ne marche pas

Répondez « Non, il y a un problème », puis décrivez ce que vous voyez, avec vos mots. Pulse le traite comme une remarque Critique, corrige, puis vous redonne le test.

Le problème persiste après deux corrections

Pulse s'arrête, l'explique simplement et le note dans le rapport. Lancez /pulse:get-help : vous obtenez une demande d'aide prête à envoyer.

Exemples

/pulse:review T4

Un regard extérieur repère les oublis, et un essai en marche prouve que ça fonctionne ; votre test manuel le confirme ensuite. Claude Code va vous demander l'accord pour lancer l'application et l'essayer : c'est ainsi que je prouve que chaque critère fonctionne.

Verdict : ⚠️ À corriger · 1 remarque Haute. En clair : une cliente peut prendre rendez-vous à une date déjà passée. 🧪 À vous de tester : votre fiche SMOKE-TEST-US-001-T4-confirmer-le-rendez-vous.md (5 étapes, environ 3 minutes). L'application est ouverte : tapez http://localhost:3000 dans votre navigateur. Étape 1 : choisissez demain, cliquez sur « 10 h », tapez « Léa Martin », cliquez sur Valider ; le message de confirmation s'affiche. Le test est-il concluant ?

Oui, tout fonctionne

Corriger Critique, Haute, Moyenne et les Basses retenues (Recommandé) / Seulement les Critiques / Je regarde d'abord ?

Corriger (Recommandé)

Corrigé : la date est maintenant vérifiée côté serveur. Relecture de contrôle : ✅ Validé. Refaites le test rapidement : une date passée est refusée. Concluant ?

Oui, tout fonctionne

T4 est prête. ➡️ Prochaine étape : /pulse:commit

/pulse:review

Je reprends la tâche en cours : T7 – Afficher les rendez-vous du jour. Verdict : ✅ Validé. 🧪 À vous de tester : votre fiche SMOKE-TEST-US-002-T7-afficher-les-rendez-vous-du-jour.md (3 étapes, environ 3 minutes). L'application est ouverte : tapez http://localhost:3000 dans votre navigateur. Étape 1 : cliquez sur « Aujourd'hui », dans le menu ; tous les rendez-vous du jour s'affichent, du plus tôt au plus tard. Le test est-il concluant ?

Non, il y a un problème

Lequel ?

Les rendez-vous de l'après-midi n'apparaissent pas.

Je le traite comme une remarque Critique et je corrige. Relecture de contrôle : ✅ Validé. Refaites le test : les rendez-vous de l'après-midi apparaissent-ils ?

Commandes liées

/pulse:implement : réalise la tâche à relire.
/pulse:commit : enregistre la tâche relue et testée.
/pulse:get-help : demander de l'aide quand un problème persiste.
/pulse:security : un contrôle complet de la sécurité, au-delà d'une tâche.
/pulse:test : lancer tous les tests automatiques du projet.