Étape 2 · Décrire

`/pulse:tech`

Choisir la pile technique à partir du besoin (ou documenter celle d'un projet existant), comparer 2 à 3 options vérifiées sur la documentation officielle, et produire docs/technical.md, le bloc Pile technique de CLAUDE.md, la mémoire technique et la mise en place.

Description

Cette commande choisit avec vous les outils de votre appli : le langage, l'endroit où sont gardées les données, la connexion des utilisateurs, l'hébergement. On appelle cet ensemble la pile technique. Pulse joue le rôle d'un architecte qui parle simplement : « On comprend d'abord le besoin, et on choisit les outils après. Le plus simple qui répond au besoin est le meilleur choix. »

Dans un projet neuf, Pulse lit votre brief et votre PRD, pose seulement les questions qui restent, puis construit 2 ou 3 options vraiment différentes. Des assistants vérifient chacune en parallèle sur la documentation officielle et les pages de prix. Vous voyez un tableau, une recommandation, et vous choisissez.

Dans un projet qui a déjà du code, Pulse décrit simplement les outils déjà utilisés, avec les manques constatés, et vous demande de confirmer. Dans les deux cas, il peut ensuite préparer le code de départ, et même mettre en ligne une première page dès aujourd'hui.

Les options comparées
A · Pile Pulse next   ✅ code de départ vérifié, recettes prêtes
B · Service géré      ⚠️ offre gratuite limitée
C · Serveur à soi     ✅ plus de pièces à comprendre

➡️ Je recommande A : c'est l'option qui demande le moins d'essais.
→ Option A (Recommandé) / Option B / Option C / Revoir un besoin

Un exemple de comparaison, avec le verdict de vérification de chaque option.

Pourquoi l'utiliser

Des outils adaptés à votre besoin. Chaque proposition part de votre projet, plutôt que d'une habitude ou d'une mode.
Des faits vérifiés. Une offre gratuite, un prix ou une limite sont affirmés seulement après vérification sur la source officielle ; ce qui reste invérifiable est signalé.
Une seule référence pour la suite. docs/technical.md guide ensuite la spec, le plan et le code.
En ligne dès le premier jour. Mettre en ligne une page presque vide, c'est découvrir aujourd'hui les réglages de l'hébergeur, plutôt qu'à la fin, avec tout le projet en jeu.

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:prd : la première version guide le choix.
Avant /pulse:ui identite et /pulse:us.
Dans un projet qui a déjà du code, pour décrire les outils en place.
Quand un besoin a changé : Pulse vous propose de revoir ou de garder vos choix.

Comment la lancer

/pulse:tech [contrainte ou préférence technique (facultatif)]

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

Sans rien : Pulse part de votre brief et de votre PRD.
Une contrainte ou une préférence (facultative) : elle guide les options proposées, par exemple un hébergement en France ou une technologie que vous connaissez déjà.

/pulse:tech

/pulse:tech "données hébergées en France"

Ce qu'elle produit

Fichier	À quoi il sert
`docs/technical.md`	La référence technique : vos besoins, les options comparées, la pile retenue, l'organisation des fichiers, les commandes du projet, qui peut voir quelles données, les noms des clés secrètes, l'hébergement, la mise en place et ce qu'on a écarté.
`CLAUDE.md`	Sa section « Stack technique » reçoit un résumé de la pile et les commandes du projet.
`aidd_docs/memory/technical.md`	Une ligne datée par décision technique. Les outils retenus restent décrits dans `docs/technical.md`.
`.gitignore`, `.env.example`	Complétés selon la pile : ce que Git doit ignorer, et les noms de vos clés secrètes, sans leur valeur.

Si vous acceptez « Préparer le code de départ maintenant », Pulse installe les fichiers de départ de la pile, vérifie que l'appli se lance sur votre ordinateur et applique votre apparence si docs/design.md existe. Une décision difficile à défaire (où sont gardées les données, comment on se connecte) peut aussi devenir un fichier de décision.

Risques et précautions

Le choix vous appartient. Pulse recommande, en donnant sa raison ; vous choisissez parmi les options, ou demandez à revoir un besoin.
Vos fichiers sont gardés. Pendant la préparation du code de départ, CLAUDE.md, README.md et .gitignore sont complétés, jamais écrasés.
La mise en ligne attend votre accord, puis Claude Code vous demande d'autoriser l'enregistrement et l'envoi vers votre dépôt en ligne.
Un paiement reste en mode test : cartes de test, transactions fictives. Le passage en mode réel est votre décision, au moment de la mise en ligne.

Problèmes et solutions

Pulse me dit qu'il manque le PRD

Le PRD décrit la première version, qui guide le choix. Lancez /pulse:prd ; vous pouvez aussi continuer sans, Pulse le signalera dans ses choix.

Pulse me signale une contradiction

Deux de vos réponses ne vont pas ensemble, par exemple « paiement en ligne » avec « budget 0 € et aucun compte ». Tranchez : Pulse construit ensuite les options sur votre réponse.

Aucune option ne passe la vérification

Pulse vous explique le blocage commun et revient aux besoins. Assouplir une contrainte (budget, hébergement) ouvre souvent de nouvelles options.

J'avais déjà fait mes choix techniques

Pulse vous demande s'il faut les revoir (un besoin a changé) ou les garder. Gardez-les si rien n'a bougé.

Je préfère installer le code de départ plus tard

Choisissez « Plus tard, avec la première tâche » : la mise en place se fera alors comme première tâche du premier plan.

Exemples

/pulse:tech

On comprend d'abord le besoin, et on choisit les outils après. D'après votre PRD : vos clientes réservent, vous consultez, les données sont partagées. Il me manque deux réponses. Combien de rendez-vous par semaine ? → Une centaine (Recommandé) / Quelques-uns / Plusieurs centaines Quel budget par mois acceptez-vous ? → 0 à 10 € (Recommandé) / 10 à 50 € / Plus

Une centaine · 0 à 10 €

pulse-aidd piles

Trois options vérifiées sur leur documentation officielle. Je recommande la pile Pulse next : c'est l'option qui demande le moins d'essais pour obtenir un code juste. → Option A (Recommandé) / Option B / Option C / Revoir un besoin

Option A

docs/technical.md est écrit. → Préparer le code de départ maintenant (Recommandé) / Plus tard, avec la première tâche

/pulse:tech

Voici les outils que j'observe dans votre projet, chacun avec le fichier où je l'ai vu. Manque constaté : aucun test automatique. → C'est bien ça / Corriger quelque chose

C'est bien ça

Commandes liées

/pulse:prd : décider de la première version, qui guide le choix.
/pulse:ui : l'étape suivante, facultative, pour choisir l'apparence.
/pulse:memory creer : juste après, pour un projet qui a déjà du code : les habitudes et les pièges propres à ce code.
/pulse:us : écrire les user stories.
/pulse:deploy : mettre le site en ligne et le tenir à jour.
/pulse:cicd : un contrôle automatique à chaque envoi, une fois le dépôt en ligne relié.
/pulse:secrets : savoir où sont vos clés et les renouveler.