Étape 6 · Être trouvé

`/pulse:perf`

Mesurer et améliorer la vitesse vécue par les visiteurs : chargement simulé en plusieurs passages (médiane), données des vrais visiteurs, 3 priorités corrigées avec avant/après, mesure réelle, budget et suivi automatique.

Description

« Imaginons un visiteur sur téléphone, en 4G moyenne. Voici ce qu'il vit en ouvrant votre site. » Cette commande mesure 3 à 5 pages de votre site, une par type de page (accueil, liste, détail, formulaire), comme sur un téléphone moyen. Chaque page est chargée plusieurs fois et Pulse garde la valeur du milieu, la médiane, pour éviter de conclure sur un passage chanceux.

Trois mesures comptent pour vos visiteurs : l'affichage du contenu principal (le plat principal arrive sur la table), la stabilité de la page (elle ne saute pas au moment de cliquer) et la réaction aux clics. Pulse sépare toujours deux sources : la simulation, qui trouve les causes, et vos vrais visiteurs, quand Google a assez de données. Il retient au plus 3 priorités, chacune avec ce que vit le visiteur, la cause en mots simples, le gain attendu et qui décide. Après correction, il compare l'avant et l'après, chiffres à l'appui.

Simulation de Google, téléphone moyen en 4G lente, médiane de 3 passages
  Accueil      🟠 contenu principal 3,1 s · stabilité 🟢 · blocages 🟢
  Réserver     🟢 contenu principal 1,9 s · stabilité 🟢 · blocages 🟢

Priorité 1 : la grande photo de l'accueil arrive tard.
  Gain attendu : environ 1 s · Pulse peut le corriger seul

Le verdict de /pulse:perf : une phrase par page, la source, puis les priorités.

Ce qui est juste sur Google : il tient compte de l'expérience des vrais visiteurs, parmi beaucoup d'autres signaux ; la pertinence du contenu passe avant. Le score de la simulation n'est pas utilisé pour le classement.

Pourquoi l'utiliser

Vous voyez ce que vit votre visiteur. Des feux 🟢 🟠 🔴 et une phrase par page, en mots simples.
Des chiffres fiables. Une médiane de plusieurs passages, avec sa source ; une mesure instable se refait avant de conclure.
Trois priorités, pas cinquante. Le plus grand gain d'abord ; ce qui relève d'un choix (police, vidéo d'accueil, outil tiers) vous est laissé, avec ses conséquences.
Une amélioration prouvée. Pulse annonce un progrès seulement quand la comparaison avant/après le montre vraiment.

Quand l'utiliser

1 Démarrer
2 Décrire
3 Préparer
4 Construire
5 Mettre en ligne
6 Être trouvé
7 À tout moment

Juste après la première mise en ligne : /pulse:deploy propose une première mesure de l'accueil, comme point de départ.
Quand une nouvelle version change une page suivie : /pulse:deploy vous propose de remesurer.
Après une mesure avec des priorités : corriger.
Pour garder la vitesse dans le temps : suivre, avec un budget et une vérification chaque semaine.

Comment la lancer

/pulse:perf [mesurer | corriger | suivre]

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

mesurer (par défaut) : « Mon site est-il rapide ? ». Les pages à suivre sont proposées puis validées par vous, mesurées 3 fois chacune (environ 30 secondes par passage), puis notées dans docs/performance.md.
corriger : « Que faut-il changer, et ça a marché ? ». Vous choisissez les priorités ; Pulse mesure l'avant, corrige, mesure l'après en 5 passages, puis compare.
suivre : « Mes vrais visiteurs vivent-ils la même chose ? ». Trois volets facultatifs : une mesure chez les vrais visiteurs, leur tendance dans le temps, et un budget vérifié automatiquement.

/pulse:perf

/pulse:perf corriger

/pulse:perf suivre

Ce qu'elle produit

Fichier	À quoi il sert
`docs/performance.md`	Les pages suivies, la dernière mesure, les vrais visiteurs, les priorités et leur statut, le budget, l'historique avec chaque avant/après.
`docs/performance/mesures/<date>.json`	Le détail de chaque mesure, pour comparer plus tard.
Le code du site	Avec `corriger` : seulement ce que demande la priorité choisie.
`scripts/perf.js` et le fichier des contrôles automatiques	Avec `suivre`, si vous l'acceptez : la vérification du budget chaque semaine.
La mention de confidentialité du site	Avec la mesure chez les vrais visiteurs : l'outil choisi et ce qu'il recueille.
`docs/lexique.md`	Les mots expliqués en chemin, avec leurs images du quotidien.

Risques et précautions

Mesurer ne change rien au site. Pulse lit le site en ligne, ou le construit pour la production sur votre ordinateur, puis arrête le serveur qu'il a lancé, lui seul.
Une correction passe par vos choix. Vous choisissez les priorités ; avec la simulation de Google, l'« après » se mesure sur le site en ligne, donc après une mise en ligne faite avec votre accord.
La vérification automatique se montre avant d'être écrite. Un budget dépassé fait échouer la tâche de la semaine et le dépôt vous prévient par e-mail ; vos versions parallèles restent libres d'être acceptées.

Problèmes et solutions

Une page est marquée « Instable »

Ses chiffres varient trop d'un passage à l'autre. Pulse la remesure seule, en 5 passages, avant d'en parler. Si l'instabilité reste, il cherche un contenu qui change à chaque chargement : carrousel, animation, image chargée en différé.

« Pas encore de données » pour les vrais visiteurs

C'est normal pour un site récent ou peu visité : Google n'a pas assez de visites. /pulse:perf suivre installe une mesure chez vos visiteurs, qui donne des chiffres dès les premières visites.

La comparaison dit « dans le bruit »

L'écart ne suffit pas pour conclure : aucune amélioration n'est annoncée. Pulse propose de remesurer.

Les chiffres changent d'un ordinateur à l'autre

Une mesure faite sur votre poste se compare seulement avec une autre mesure du même poste. Pour des chiffres comparables partout, créez la clé Google : la mesure passe alors par les serveurs de Google.

Le site n'est ni en ligne ni prêt à construire

Il n'y a encore rien à mesurer. Réalisez la première tâche du plan, ou mettez le site en ligne avec /pulse:deploy.

Exemples

/pulse:perf

pulse-aidd perf cle

Pas de clé Google pour l'instant. Mesurer sur ce poste, sans clé (Recommandé pour commencer) · Créer ma clé Google d'abord (5 minutes)

Mesurer sur ce poste

Pages proposées, une par type : l'accueil, la liste des prestations, la page de réservation. (Recommandé) Les pages réservées aux clientes connectées restent hors de la mesure. Environ 30 secondes par passage, 3 passages par page.

pulse-aidd perf mesurer http://localhost:3456/,http://localhost:3456/prestations,http://localhost:3456/reserver --source local --passages 3

Accueil 🟠 : le contenu principal s'affiche en 3,1 s (médiane de 3 passages, écart 0,2 s, mesure sur ce poste). Priorité 1 : la grande photo de l'accueil arrive tard ; elle est découverte après le reste. Gain attendu : environ 1 s. Pulse peut le corriger seul. ➡️ Prochaine étape : /pulse:perf corriger

/pulse:perf corriger

Priorités à faire : la grande photo de l'accueil (Recommandé). Je mesure d'abord l'« avant » sur ce poste, en 5 passages.

pulse-aidd perf comparer docs/performance/mesures/2026-10-10-avant.json docs/performance/mesures/2026-10-10-apres.json

Contenu principal de l'accueil : 3,1 s → 2,0 s, mieux ✅ (les 5 passages d'après battent tous ceux d'avant). Noté dans docs/performance.md. Enregistrer avec /pulse:commit, puis mettre en ligne ?

Commandes liées

/pulse:deploy : mettre en ligne une correction, et mesurer après la première mise en ligne.
/pulse:cicd : les contrôles automatiques, où se branche la vérification du budget.
/pulse:seo : être trouvé, l'autre moitié de l'étape.
/pulse:ui : l'accessibilité réelle et l'apparence.
/pulse:security : les en-têtes de sécurité.
/pulse:fix : une lenteur côté serveur, notée dans le rapport.