Mode complet : prêt pour de vrais clients

1 Séance 1 : décrire l'appli Environ 3 h

Objectif : passer de l'idée à des user stories prêtes à construire, sans une ligne de code. Six commandes, dans l'ordre. Chacune pose ses questions, écrit un document et attend votre accord.

Préparer le projet : /pulse:init

Objectif : créer le dossier du projet et choisir le parcours complet. Environ 15 min

Créez un dossier vide salon-lila, ouvrez-le dans VS Code (Fichier → Ouvrir le dossier…), ouvrez le panneau Claude Code, puis tapez :

/pulse:init salon-lila

Pulse vous demande une phrase de description, votre niveau et la quantité d'explications voulue, puis crée les règles du projet, sa mémoire et un premier enregistrement. Il propose ensuite de protéger vos clés et de relier le projet à un dépôt distant (une copie privée sur GitHub). À la fin, il vous demande quel parcours suivre : choisissez le parcours complet. Le détail est sur la page /pulse:init.

Raconter l'idée : /pulse:brainstorm

Objectif : que Pulse comprenne le métier du salon, avec vos mots. Environ 45 min

/pulse:brainstorm "un carnet de réservations pour mon salon de coiffure"

Pulse pose d'abord quelques questions essentielles, une à la fois : qui utilise l'outil, comment les rendez-vous se prennent aujourd'hui, ce qui coince. Répondez avec des exemples concrets : la liste des prestations et leur durée, les horaires du salon. Il écrit ensuite une courte histoire de votre outil (« Il était une fois… ») et vous demande si c'est bien ça. Les mots du métier (prestation, créneau, rendez-vous) vont dans le glossaire du projet. Voir /pulse:brainstorm.

Décider de la première version : /pulse:prd

Objectif : trier les fonctions entre Indispensable, Essentiel, Optionnel et En attente. Environ 30 min

/pulse:prd

Pulse liste ce que l'outil doit permettre, puis vous pose la question clé : « Si vous ne pouviez livrer que 3 choses dans quinze jours, lesquelles ? ». Les Indispensables forment la première version : la plus petite réellement utilisable. Pulse vous demande aussi si le salon doit être trouvé sur Google, et ce qui vous fera dire « la première version est prête ». Voir /pulse:prd.

Pour relire le PRD, ouvrez docs/prd.md dans l'explorateur, puis Ctrl + Maj + V (Cmd + Maj + V sur Mac) : le tableau s'affiche mis en forme.

Choisir les outils : /pulse:tech

Objectif : retenir la pile Next.js du pack et préparer le projet de départ. Environ 45 min, comptes compris

/pulse:tech

Pulse remplit ce qu'il sait déjà, pose les questions qui restent sur votre besoin, puis compare 2 ou 3 options vérifiées sur la documentation officielle. Avec le pack installé, la pile Next.js en fait partie : un projet de départ vérifié, des recettes prêtes, les pièges connus déjà traités. Pulse la recommande quand elle convient ; le choix vous appartient. Voir /pulse:tech.

Ensuite, Pulse propose de préparer le code de départ. Il vous guide pour créer un compte Neon (la base de données, rangée à Francfort), avec une base de développement pour vos essais, et un compte Vercel (l'hébergeur). Puis il propose de mettre en ligne la page de départ dès aujourd'hui : acceptez, vous découvrez les réglages de l'hébergeur tant que l'enjeu est petit.

Choisir l'apparence : /pulse:ui identite

Objectif : voir 2 ou 3 apparences possibles et en choisir une. Facultatif, mais à faire avant les user stories. Environ 30 min

/pulse:ui identite

Pulse vous interroge en langage courant : où et sur quel écran l'outil sert, sa personnalité en 3 mots, des sites dont vous aimez l'allure. Des assistants dessinent ensuite plusieurs planches, que vous comparez dans votre navigateur. Vous en choisissez une, ou un mélange. Pulse vérifie la lisibilité des couleurs, écrit docs/design.md, puis propose d'appliquer l'apparence au code. Voir /pulse:ui.

Écrire les user stories : /pulse:us

Objectif : découper le besoin en user stories vérifiées et rangées dans l'ordre de réalisation. Environ 30 min

/pulse:us

Pulse propose des groupes de user stories (par exemple « Réserver un rendez-vous », « Tenir le carnet du salon », « Prévenir les clientes »), puis écrit chaque US : « En tant que… je souhaite… afin de… », un exemple réaliste, et des critères « Étant donné… Lorsque… Alors… », dont au moins un cas d'erreur. Il vous pose les cas limites sous forme de scénarios concrets. Rien n'est enregistré avant votre « Valider et sauvegarder ». Voir /pulse:us.

2 Séance 2 : construire US-001, prendre rendez-vous Environ 3 h

Objectif : une cliente réserve seule, et vous l'avez testé de vos mains. Une seule commande mène l'US de bout en bout ; le détail, commande par commande, reste possible.

Lancer l'US : /pulse:spirc US-001

Objectif : écrire la spec et le plan d'US-001, puis réaliser ses tâches une à une. Environ 2 h 30

/pulse:spirc US-001

Comme US-001 n'a ni spec ni plan, Pulse les écrit d'abord avec vous :

• La spec fixe ce que vous voulez obtenir : écrans, informations, règles, exemples. Pulse vous montre ce qu'il propose d'ajouter (un message de confirmation, par exemple) et vous gardez ce que vous voulez. Une fois validée, la spec ne bouge plus.
• Le plan choisit comment construire : où ranger les rendez-vous, quelles protections, quels fichiers, puis 1 à 4 petites tâches que vous pouvez tester chacune en moins de 2 minutes. Avant de vous le montrer, Pulse le fait vérifier par un outil : chaque critère de la user story a sa tâche, chaque test prévu a sa place, les tâches s'enchaînent bien. Le formulaire étant ouvert à tous, le plan reprend les recettes du pack qui freinent les robots et les envois en rafale.

Puis, pour chaque tâche : un assistant la réalise, deux autres la relisent et l'essaient sans l'avoir écrite, vous la testez, et elle est enregistrée. L'animation de la page /pulse:spirc montre ce déroulé et ses arrêts pour vous.

Pour le suivre, ouvrez docs/guide/index.md dans l'explorateur, puis Ctrl + Maj + V (Cmd + Maj + V sur Mac).

En cours de route, Pulse vous demande parfois une action à faire vous-même, par exemple appliquer les changements à votre base de développement. Il vous guide pas à pas. Les clés techniques dont l'appli a besoin sont créées et rangées dans .env sans jamais s'afficher.

Tester chaque tâche

Objectif : vérifier vous-même que la tâche fait ce que vous vouliez. 5 à 10 min par tâche

Après la relecture, Pulse vous résume ce qui a été fait, puis vous donne les étapes du test et la commande pour ouvrir l'appli sur votre ordinateur. Tapez cette commande dans le terminal intégré de VS Code (Terminal → Nouveau terminal), puis ouvrez l'adresse indiquée dans votre navigateur. Faites le test pour de bon, comme une cliente pressée : un champ vide, un e-mail mal écrit, un créneau déjà pris.

Le même travail, commande par commande

Objectif : garder la main sur chaque étape, si vous le préférez. Facultatif. Un peu plus long

À tout moment, /pulse:test relance les tests automatiques du projet et explique chaque échec.

Relire avant de publier : la version parallèle

Objectif : travailler sur une copie du projet, et décider vous-même quand elle rejoint la version principale. 5 min de plus par US

Avec le niveau « Jamais programmé », Pulse envoie chaque tâche directement sur la version principale. Si votre page de départ est déjà en ligne, chaque tâche testée part donc aussitôt sur le site. Pour relire d'abord, dites-le quand Pulse annonce ses réglages : « Je préfère une version parallèle ». Pulse range alors les tâches de l'US sur une version parallèle, les envoie sur GitHub et y ouvre une proposition en brouillon. Vercel fournit souvent une adresse de prévisualisation pour essayer cette version sans toucher au site.

Vous pouvez aussi le faire à la main : /pulse:pr branche US-001 avant de commencer, puis /pulse:pr quand le travail est prêt. Le chemin complet est animé sur la page /pulse:pr.

3 Séance 3 : US-002, le carnet du salon 2 à 3 h

Objectif : la coiffeuse se connecte et voit les rendez-vous du jour, et personne d'autre ne les voit. À la fin de cette US, la première version part en ligne.

Construire la connexion et le carnet du jour

Objectif : une page réservée au salon, protégée côté serveur. Environ 2 h

/pulse:spirc US-002

La spec demande votre décision sur les données personnelles : sont-elles toutes nécessaires, et qui a le droit de voir quoi ? Ici : seule l'équipe du salon voit les noms et les e-mails des clientes. Le plan reprend la recette « connexion » du pack (inscription, connexion, déconnexion, pages réservées). Si la question se pose (qui peut créer un compte ?), Pulse vous la pose : c'est votre décision.

Comme US-002 est la dernière user story Indispensable, son plan se termine par deux tâches de plus : les fondations du référencement (le salon veut être trouvé sur Google) et « Mettre en ligne la première version ». Pour celle-ci, Pulse attend toujours votre accord.

Mettre en ligne la première version

Objectif : publier US-001 et US-002, et prouver que le site répond. Environ 30 min

Pulse vérifie d'abord que tout est enregistré, sans clé dans le code, que les tests passent et que l'appli se construit. Avant que le site lise sa base en ligne, il vous guide pour relier Neon à Vercel, une étape à la fois, en vous donnant le nom exact de chaque bouton. Puis il envoie la version, attend la publication et vérifie lui-même que le site répond et reste visible pour Google. La chaîne complète est animée sur la page /pulse:deploy.

4 Séance 4 : mettre en ligne pour de vrai 2 à 3 h

Objectif : un site qui se vérifie tout seul avant chaque publication, des clés bien rangées, une sécurité contrôlée. C'est ce qui sépare un prototype d'une appli prête pour de vrais clients.

Les contrôles automatiques : /pulse:cicd

Objectif : qu'une erreur soit signalée par une croix rouge sur GitHub avant d'arriver sur le site. Environ 30 min

/pulse:cicd

Pulse écrit pour GitHub un contrôle qui tourne à chaque envoi et sur chaque proposition de version parallèle : clés absentes du code, chaque scénario prévu avec son test, dépendances sans faille grave connue, règles du code, tests, construction. Il l'essaie d'abord sur votre ordinateur, l'envoie, puis vous montre le premier passage. Il propose ensuite de recevoir chaque semaine les nouvelles versions des dépendances, vérifiées par ce contrôle avant que vous les acceptiez. Voir /pulse:cicd.

Si vous publiez par versions parallèles, protégez aussi la version principale : une proposition la rejoindra seulement si ses contrôles sont au vert.

/pulse:cicd proteger

Le mode production : /pulse:deploy production

Objectif : préparer le site « pour de vrai » : variables, services, surveillance, retour arrière. Environ 45 min

/pulse:deploy production

Pulse fait vérifier le projet par l'hébergeur avant chaque publication : si un contrôle échoue, l'ancienne version reste en ligne. Il dresse ensuite la liste des variables du site, sans aucune valeur, et envoie celles qui manquent à Vercel, chaque envoi avec votre accord. Il vous explique la différence entre une prévisualisation et la production, vous aide à choisir une seule adresse officielle (votre nom de domaine), à créer une sonde qui vous prévient par e-mail si le site ne répond plus, et vous montre comment revenir à la version précédente. Voir /pulse:deploy.

L'audit de sécurité : /pulse:security

Objectif : vérifier que seul ce que le serveur bloque est vraiment interdit. Environ 45 min

/pulse:security

Un assistant passe tout le projet au crible de la liste de sécurité Pulse, sans rien modifier. Pulse vous donne un niveau global, explique chaque point bloquant par ce qu'un inconnu pourrait faire, puis déroule avec vous « le test du cambrioleur » : des essais à faire vous-même, un à la fois. Il propose enfin de corriger, en commençant par les points bloquants. Voir /pulse:security.

Les clés du projet : /pulse:secrets

Objectif : savoir où sont vos clés, savoir les changer, et savoir quoi faire si l'une d'elles est vue. Environ 20 min

/pulse:secrets

L'inventaire liste chaque clé par son nom, avec sa présence dans .env et chez l'hébergeur, sans jamais afficher de valeur. Pulse signale les points à corriger, du plus grave au moins grave, et tient docs/secrets.md à jour. Deux autres actions servent plus tard :

• /pulse:secrets renouveler BETTER_AUTH_SECRET : la nouvelle clé d'abord, l'ancienne coupée seulement après votre « Ça marche » en production. Aucune coupure.
• /pulse:secrets fuite : dès qu'une clé a été vue ailleurs que dans .env (dépôt, conversation, capture d'écran, alerte de GitHub). L'ancienne clé est rendue inutilisable tout de suite, puis remplacée.

Le détail est sur la page /pulse:secrets.

5 Séance 5 : US-003, le rappel la veille Environ 2 h

Objectif : ajouter une fonction à un site déjà en ligne, avec toute la routine : version parallèle, contrôles au vert, prévisualisation, puis acceptation par vous.

Construire le rappel par e-mail

Objectif : chaque cliente reçoit un e-mail la veille de son rendez-vous. Environ 1 h 30

/pulse:spirc US-003

Cette fois, demandez une version parallèle dès l'annonce des réglages. La spec pose les vraies questions du métier : à quelle heure partent les rappels, que contient l'e-mail, que se passe-t-il pour un rendez-vous pris le jour même ? Le plan reprend la recette « email » du pack pour l'envoi. Le déclenchement chaque jour n'a pas de recette toute prête : Pulse le conçoit dans le plan et vous le présente avant de construire.

Pour vos tests, Pulse vous guide pour installer Mailpit sur votre ordinateur : il capture tous les e-mails envoyés en local, et rien ne part vers de vraies adresses. Vous lisez les rappels dans votre navigateur, sur http://localhost:8025.

Envoyer de vrais e-mails en ligne

Objectif : brancher un vrai service d'envoi pour le site en ligne. Environ 20 min

Pour essayer, un compte Gmail créé pour le projet (jamais votre compte personnel) suffit, avec un mot de passe d'application. Pour un vrai lancement, Pulse conseille le service d'envoi d'un fournisseur, avec le nom de domaine du salon. La valeur réelle part en production ; les prévisualisations reçoivent une valeur de test.

Accepter la proposition

Objectif : publier US-003 quand tout est au vert. Environ 10 min

Sur GitHub, la proposition d'US-003 montre ses contrôles automatiques et l'adresse de prévisualisation. Contrôles au vert, prévisualisation testée : cliquez « Merge ». Le site se met à jour tout seul. Revenez ensuite dans Claude Code : Pulse récupère la version principale à jour et retire la version parallèle devenue inutile.

Et l'acompte, US-004 ?

US-004 est Optionnelle : elle attend son tour. Le jour où vous la lancez avec /pulse:spirc US-004, la recette « paiement » du pack l'installe en mode test : aucune vraie carte, aucun vrai argent. Passer au paiement réel reste votre décision, au moment de la mise en ligne : compte du service de paiement activé, conditions de vente, mentions légales.

6 Séance 6 : être trouvé Environ 2 h, puis tous les 28 jours

Objectif : que les gens qui cherchent un coiffeur dans le quartier trouvent le salon, et que la page s'ouvre vite sur leur téléphone.

Les textes des pages : /pulse:rediger

Objectif : une page d'accueil qui parle aux clientes, avec des faits vrais. Environ 30 min

/pulse:rediger accueil

La première fois, Pulse fixe la voix du site avec vous : vous ou tu, trois traits de ton, la promesse du salon en une phrase. Puis il vous interroge sur la page : pour qui, quel bouton, quels faits (adresse, horaires, prestations). Un fait inconnu reste marqué « [à compléter] ». Un contrôle vérifie que le texte ne sonne pas écrit par une IA. Vous choisissez ensuite de le garder de côté ou de l'intégrer à la page. Voir /pulse:rediger.

Le référencement : /pulse:seo

Objectif : vérifier que Google peut entrer, lire et garder vos pages. Environ 30 min

/pulse:seo

Les fondations ont été posées dans le plan d'US-002. L'audit lit maintenant le site servi, comme un robot, et range ses constats en quatre questions : Google peut-il venir, garder la page, comment se présente-t-elle, mérite-t-elle d'être choisie ? Puis deux actions utiles : /pulse:seo textes, où vous choisissez entre deux titres et deux descriptions par page, et /pulse:seo ia, où vous décidez ce que les assistants IA peuvent faire du site. Voir /pulse:seo.

La vitesse : /pulse:perf

Objectif : voir ce que vit une cliente sur téléphone, puis l'améliorer, chiffres à l'appui. Environ 30 min

/pulse:perf

Pulse mesure 3 à 5 pages comme sur un téléphone moyen en 4G, trois fois chacune, et garde la valeur du milieu. Sans clé Google, il mesure sur votre ordinateur : c'est très bien pour commencer. Il donne une phrase de verdict par page et trois priorités au plus. Ensuite, /pulse:perf corriger applique les priorités choisies et annonce seulement ce qui va vraiment mieux ; /pulse:perf suivre propose la mesure chez les vrais visiteurs et une vérification chaque semaine. Voir /pulse:perf.

Prévenir Google : /pulse:seo lancer et /pulse:search-console relier

Objectif : prouver à Google (et à Bing) que le site est à vous, et déclarer son plan. Une seule fois. Environ 30 min

/pulse:seo lancer
/pulse:search-console relier

Ces deux commandes demandent le site sur son adresse définitive. Vous agissez sur Search Console avec votre compte Google, guidée une étape à la fois : ajouter la propriété, la faire vérifier, déclarer le plan du site, l'importer dans Bing. Pour que Pulse lise vos chiffres, le plus simple est d'exporter un fichier depuis Search Console quand vous voulez un rapport : aucun secret, rien à installer. Voir /pulse:search-console.

7 La liste « prête pour de vrais clients »

Avant d'annoncer le site à vos clientes, cochez chaque ligne. Chacune renvoie à l'étape qui la règle.

• US-001 et US-002 sont terminées, et vous les avez testées vous-même, en local puis en ligne (séance 2, séance 3).
• Les contrôles automatiques passent au vert à chaque envoi (/pulse:cicd).
• Le site vit sur son adresse définitive, avec une offre d'hébergement qui autorise un usage commercial.
• Le mode production est en place : variables en ligne, sonde de disponibilité, retour arrière écrit (/pulse:deploy production).
• L'audit de sécurité ne montre aucun point bloquant, et vous avez fait le test du cambrioleur (/pulse:security).
• L'inventaire des clés est à jour dans docs/secrets.md (/pulse:secrets).
• Les e-mails partent par un vrai service d'envoi, au nom de domaine du salon, et seulement depuis la production (séance 5).
• Une page dit quelles données vous gardez (nom, e-mail), pourquoi et combien de temps. Vous pouvez la faire écrire avec /pulse:rediger ; relisez chaque fait.
• Search Console est relié, et la vitesse de l'accueil est mesurée (séance 6).

8 L'entretien régulier 15 min par semaine

Objectif : garder l'appli à jour, sûre et trouvable, sans y penser. Un site en ligne vit : quelques gestes réguliers suffisent.

Pour mettre à jour Pulse, ouvrez le terminal intégré de VS Code (Terminal → Nouveau terminal) et tapez les trois lignes ci-dessous. Fermez ensuite VS Code et rouvrez-le : la nouvelle version se charge au démarrage.

claude plugin marketplace update pulseia
claude plugin update pulse@pulseia
claude plugin update pulse-next@pulseia

La fenêtre /plugins du panneau Claude Code montre les plugins installés et rafraîchit le catalogue (onglet Marketplaces) ; le terminal reste le chemin documenté pour mettre à jour les plugins eux-mêmes.

Après une mise à jour, /pulse:init repère ce qui a changé et propose de mettre votre projet à niveau, sans rien perdre.

9 Si quelque chose ne va pas

Rien n'est perdu : chaque version est enregistrée, et chaque situation a sa commande.

Retrouvez toutes les commandes dans la liste des commandes, et l'autre parcours dans les tutoriels.