# Guide de Bastide

Ce guide est publié en français et en anglais, avec le produit : chaque page existe dans les deux langues, sous le même nom de fichier. Il est écrit pour être suivi par une personne comme par un agent, sans autre document que ceux qu'il cite.

Le parcours complet tient en trois pages, à lire dans l'ordre :

- [Créer un projet](project.md) : brancher votre agent, puis créer un projet, sa base et son premier déploiement en un appel.
- [Déployer](deploy.md) : construire une branche, suivre le travail, lire le journal de construction.
- [Restaurer](restore.md) : revenir à la release précédente sans reconstruire, défaire l'opération, ou sortir un projet de la corbeille.

## Les références

La référence est engendrée du registre des opérations : elle ne peut pas diverger du produit.

- Référence de l'API : [reference/api.md](../reference/api.md) (anglais : [reference/en/api.md](../reference/en/api.md)).
- Référence de la ligne de commande : [reference/ligne-de-commande.md](../reference/ligne-de-commande.md) (anglais : [reference/en/command-line.md](../reference/en/command-line.md)).
- Référence MCP : [reference/mcp.md](../reference/mcp.md) (anglais : [reference/en/mcp.md](../reference/en/mcp.md)).
- Schémas pour agents : [mcp-tools.json](../mcp-tools.json) (le catalogue des outils MCP, avec le schéma JSON de chaque entrée) et [openapi.json](../openapi.json) (le document OpenAPI de l'API HTTP).

La liste lisible par un agent est `llms.txt`, à la racine du site.

## Conventions

- Une seule version d'API dans le chemin : `/v1`. L'adresse de l'API est `https://api.bastide.fr`.
- Un outil MCP porte le nom de son opération, avec des soulignés à la place des points : `deployment.create` devient `deployment_create`.
- Toute écriture accepte une clé d'idempotence : rejouée avec la même clé, elle rend la première réponse sans nouvel effet.
- Un secret n'est jamais relu : il est rendu une seule fois à sa création.