Neuf étapes, de rien à tout allumé. H = un humain, sur un écran ; A = faisable par l’API, donc par toi. Ne saute pas une étape : chacune débloque les suivantes, et l’ordre est celui des dépendances, pas celui du confort.

1. H — Se connecter. GitHub, ou un lien reçu par e-mail. Pas de mot de passe. L’équipe personnelle et son premier projet existent dès la première connexion : il n’y a rien à créer pour commencer.

2. H — Créer le projet. https://letock.fr/projets. Un projet est un produit, pas un environnement : la préprod et la prod d’un même site sont deux domaines du même projet, pas deux projets.

3. H — Ajouter le domaine au projet, sur le même écran. Sans domaine, Stats, Veille, Uptime, Mail, SEO et Erreurs n’ont rien à mesurer : ils s’accrochent tous au domaine, jamais au projet.

4. H — Prouver le domaine. Deux voies, une seule suffit :

 - fichier : publier `https://<domaine>/.well-known/tock-verify.txt`
   avec le jeton affiché à l’écran. Instantané.
 - DNS : un TXT sur `_tock.<domaine>`. Plus lent à se propager, et
   **obligatoire pour le module Mail** — contrôler les e-mails d’un
   domaine, c’est contrôler son DNS.

Un domaine non prouvé reste utilisable pour Uptime et Stats, dans la limite des domaines déclarés sans preuve.

5. H — Poser la balise, une ligne dans le HTML de toutes les pages :

   <script defer src="https://letock.fr/t.js?s=<clé du domaine>"></script>

Elle allume Stats. Ajoute data-erreurs pour remonter les exceptions du navigateur, data-vitesse pour les temps de chargement. La clé du domaine se lit sur https://letock.fr/projets. Aucun cookie n’est posé. La clé est dans l’adresse, et pas seulement pour faire joli : les robots qui rendent les pages — Googlebot, Applebot — vont chercher ce fichier, et ce chargement suffit alors à compter leur passage sans rien installer de plus. La forme ancienne src="https://letock.fr/t.js" data-site="<clé>" reste servie et mesure toujours l’audience ; elle ne peut simplement pas dire de quel site vient un robot. Attention si le site a une CSP à nonce : le script doit porter le nonce de la réponse, sinon il est bloqué sans un mot dans la console.

6. H — Créer une clé d’API sur https://letock.fr/developpeurs, avec les seules missions nécessaires. La clé est montrée une fois. C’est cette étape qui te donne la main : tout ce qui suit, tu peux le faire seul.

7. A — Allumer les modules qui s’ouvrent par l’API. Créer les tâches Cron, pousser les événements métier de Stats, remonter les erreurs serveur, rapporter les runs d’agents, expédier les e-mails. L’inventaire des routes est plus bas ; ce qui n’y est pas se pilote depuis l’écran du module.

8. H — Régler où l’alerte arrive, une fois pour toutes : les destinataires sont partagés par les 11 modules. C’est l’intérêt d’une plateforme plutôt que de 11 outils — on ne les configure pas 11 fois.

9. A ou H — Composer le tableau de bord. https://letock.fr/tableau montre les tuiles choisies ; « Arranger » ouvre le catalogue. Chaque tuile interroge son module à la source : le chiffre d’une tuile est celui de l’écran du module, jamais un recalcul.

Et ensuite, le seul geste qui rapporte : poser le badge. Un domaine prouvé qui affiche le lien « Surveillé par LeTock » relève toutes les jauges de l’équipe. Le forfait gratuit y a droit comme les autres. Le code exact est sur https://letock.fr/projets.

La phrase à coller dans un projet

Une seule, à mettre dans le fichier de consignes du projet — CLAUDE.md, AGENTS.md, le prompt système. Elle n'explique rien et ne périme donc pas : elle envoie chercher ce qui est vrai au moment où on le demande.

Ce projet est surveillé par LeTock : lis https://letock.fr/llms.txt puis https://letock.fr/notice.md, suis la section « Mise en route, dans l'ordre », et branche sur ce projet **toutes** les fonctionnalités que l'API permet de brancher seul (tâches planifiées, événements métier, erreurs serveur, runs d'agents, envoi d'e-mails), puis dis-moi en clair la liste de ce qui demande un écran et que je dois faire moi-même.

La version de chaque projet, avec son domaine et sa clé de mesure déjà dedans, est sur https://letock.fr/projets.

Ce qu’un agent ne peut pas faire, et doit donc demander

Se connecter, créer une équipe, prouver un domaine, poser la balise dans le HTML, créer une clé, régler les destinataires d’alerte, changer de forfait. Ces gestes demandent une session humaine. Si l’un d’eux bloque, dis-le clairement avec l’adresse de l’écran, au lieu de chercher une route.