Utiliser cette doc avec votre IA

Pourquoi cette page

Cette documentation est conçue pour être lue par un assistant IA autant
que par vous. Chaque page existe en Markdown brut (sans mise en page,
sans navigation) à une URL stable, et l’ensemble est disponible sous des
formats pensés pour être collés directement dans le contexte d’un agent :
vous n’avez jamais besoin d’accéder au code source de Capibara — cette
documentation, plus l’API publique, suffisent.

---

Les URLs à connaître

URL	Contenu	Format
/dev/llms.txt	Index de cette documentation : toutes les pages, groupées par catégorie, avec un résumé d’une ligne et un lien vers chaque version brute.	text/plain, convention llms.txt
/llms.txt	L’index niveau plateforme (ce qu’est Capibara, le centre d’aide utilisateur, les fiches d’apps) — il pointe vers /dev/llms.txt. C’est ce qu’un agent trouve en arrivant sur capibara.fr.	text/plain
/llms-full.txt	Tout, concaténé : présentation de la plateforme, articles du centre d’aide, puis l’intégralité des pages de cette documentation, dans l’ordre de navigation du hub.	text/plain
/dev/docs/raw/<slug>	Le Markdown brut d’une seule page (ex. /dev/docs/raw/manifeste).	text/markdown
/dev/docs/download	Une archive .zip contenant un fichier .md par page.	application/zip

Tout cela est public : ni la documentation ni ces URL ne demandent de
compte. Ce sont de simples réponses texte, faciles à récupérer avec curl
ou directement depuis le navigateur de votre agent.

curl https://capibara.fr/dev/llms.txt
curl https://capibara.fr/llms-full.txt
curl https://capibara.fr/dev/docs/raw/manifeste

---

Ce que contient /dev/llms.txt

Un index compact, dans le format standard llms.txt : un titre, un court
résumé de la plateforme, puis une section par catégorie avec un lien vers
chaque page — pratique pour qu’un agent découvre la documentation
disponible sans la charger en entier :

# Capibara for Developers

> Construisez des apps pour Capibara sans accès à son code source :
> manifeste déclaratif, permissions consenties par le tenant, API publique,
> OAuth, distribution et rev-share.

## Démarrer
- [Démarrer : votre première app, de zéro à la publication](https://capibara.fr/dev/docs/raw/demarrer): …
- [Utiliser cette doc avec votre IA](https://capibara.fr/dev/docs/raw/llm): …

## Référence
- [Référence du manifeste add-on.json](https://capibara.fr/dev/docs/raw/manifeste): …
…

/llms-full.txt, à l’inverse, ne fait aucun tri : c’est le contenu intégral
— plateforme, centre d’aide et toutes les pages de ce hub, séparées par
--- —, pensé pour être collé une seule fois dans le contexte d’un agent
qui doit ensuite répondre à des questions variées sans repartir chercher
chaque page individuellement. Si le contexte de votre agent est compté, la
section « Documentation développeur » seule suffit pour construire une app.

---

Workflow conseillé

1. Donnez /llms-full.txt à votre agent en tout début de conversation
   (collé directement, ou récupéré via un outil de navigation web si votre
   agent en a un), ou /dev/llms.txt s’il sait aller chercher les pages
   lui-même. C’est la référence la plus dense : elle contient déjà le
   manifeste exhaustif, les capabilities, les permissions, l’OAuth complet,
   l’API publique et le modèle de revenus.
2. Faites écrire le manifeste par l’agent, puis collez-le dans l’éditeur
   du portail (section Manifeste de votre app, /dev/addons/<votre-projet>/manifest)
   — l’éditeur valide en direct avec le même schéma que le serveur : les
   erreurs éventuelles de l’agent sont visibles immédiatement, sans attendre
   une soumission en review.
3. Itérez : si une erreur de validation apparaît, recopiez le message
   exact à votre agent (les messages sont listés dans Référence du
   manifeste) — ils
   sont volontairement explicites et actionnables.
4. Pour une app à backend externe, demandez à votre agent
   d’implémenter l’appel à l’API publique et le
   flux OAuth directement depuis les séquences curl
   fournies — elles sont écrites pour être traduites telles quelles dans
   n’importe quel langage.

---

Une doc, deux lecteurs

Rien dans ce hub n’est réservé à l’un ou l’autre : les pages HTML
(/dev/docs/<slug>) et leur version brute (/dev/docs/raw/<slug>)
partagent exactement le même contenu source — pas de version « appauvrie »
pour la machine. Si un détail vous semble absent quand vous travaillez avec
un agent, c’est probablement qu’il est absent tout court : signalez-le
depuis /dev/support.