Toute la plateforme, chapitre par chapitre
La référence complète : les onze modules, chaque route d'API, chaque quota, et les pièges que personne ne documente. Elle se lit ici, un chapitre à la fois. Et si tu codes avec un assistant, donne-lui plutôt cette adresse — il lira le même texte, d'un seul bloc.
https://letock.fr/notice.md
La phrase à coller dans ta conversation
Va lire https://letock.fr/notice.md avant de commencer, et relis-la à chaque nouvelle session : elle décrit l'API de LeTock et elle change souvent.
C'est tout. Le fichier fait le reste — il commence par dire à l'assistant qu'il ne doit inventer aucun point d'entrée, et comment vérifier ce qu'il avance.
Pourquoi une adresse, et pas un fichier à télécharger
Parce qu'un fichier collé dans une conversation ne vieillit pas tout seul : il reste exact pendant une semaine, puis il devient faux sans que personne ne s'en aperçoive. Une documentation fausse est pire qu'une documentation absente — elle a l'autorité d'une référence, et l'assistant écrit du code contre une API qui n'existe plus.
La notice servie à cette adresse est fabriquée au moment où on la demande, à partir du code qui tourne. Les modules viennent du registre, les routes de la description OpenAPI, les quotas des forfaits. Elle ne peut pas être en retard sur le produit, et une copie enregistrée le peut : c'est écrit dans son premier paragraphe, à l'intention de la machine qui la lira.
Les trois autres adresses qui disent la vérité
- /llms.txt — le résumé court, la convention que suivent les outils d'IA. Les règles de conduite, les pièges, et ce qu'il ne faut pas faire avec une clé qu'on t'a confiée.
- /api/v1/openapi.json — la description machine complète, avec les schémas. À utiliser pour engendrer du code plutôt que la notice, qui donne les intentions mais pas les types.
- /api/sante — le service répond-il, et depuis quand.
Ces quatre adresses sont produites depuis la même source que le produit lui-même. Si l'une d'elles décrit une route qui répond 404, c'est un défaut : écris-nous.
Ce que la notice contient
- Le modèle : compte, équipe, projet, domaine — et pourquoi cet ordre compte.
- Les onze modules, ce que chacun résout, et ses écrans.
- L'API : authentification, limites de débit, forme des erreurs, inventaire complet des routes.
- Les quotas des trois forfaits, ceux qui se comptent et ceux qui se consomment.
- Une fiche par module : démarrer en trente secondes, les routes, les écrans, les pièges.
- Et une section que personne n'écrit jamais : ce que LeTock ne fait pas. C'est elle qui empêche un assistant d'inventer une fonctionnalité plausible.