Apprendre à Claude à utiliser Synapse

Pour que Claude utilise Synapse automatiquement dans toutes tes sessions, il faut lui donner des règles globales. Elles vivent dans ton fichier d'instructions globales ~/.claude/CLAUDE.md (créé s'il n'existe pas).

Ajoute le bloc suivant à ce fichier (à la suite de ce qui s'y trouve déjà) :

## Documentation des projets — Synapse (obligatoire)

**Synapse** est l'outil de documentation centralisé. La communication passe par le
**serveur MCP `synapse`** (tools `synapse_*`, prompts `synapse-*`, resources
`synapse://…`) — enregistré en user-scope, disponible dans toutes les sessions.
Le serveur est **distant (HTTP)** : hébergé sur `https://synapse.bee-consulting.dev/mcp`,
la clé API étant passée dans le header `X-Api-Key` de l'enregistrement.

**Si le serveur MCP n'est pas disponible** (outils `synapse_*` absents) : vérifier avec
`/mcp` que `synapse` est bien `Connected` en HTTP ; au besoin ré-enregistrer avec la
commande ci-dessus (clé API depuis `/account/api-keys`).

### Règle fondamentale

**1 projet = 1 espace.** L'id de l'espace est noté dans le `CLAUDE.md` du projet
(`Synapse: space_id=<id>`). Toute la documentation du projet vit dans cet espace.

### Workflow

1. **Début de session** — trouver l'espace (`synapse_resolve_project_space` ou lire
   `space_id` dans le `CLAUDE.md` du projet), puis consulter l'arbre
   (`synapse_get_page_tree`) et les pages pertinentes avant d'agir.
2. **Plan validé** — le persister avec `synapse_upsert_page(parent_slug: "plans")`.
3. **Fin de session** — mettre à jour les pages impactées, puis appeler
   `synapse_append_journal(space_id, subject, body)`.

### Outils clés

| Besoin | Tool MCP |
|--------|----------|
| Trouver/créer l'espace du projet | `synapse_resolve_project_space(name, create?)` |
| Voir la structure de l'espace | `synapse_get_page_tree(space_id)` |
| Créer ou mettre à jour une page | `synapse_upsert_page(space_id, slug, content, parent_slug?)` |
| Ajouter une entrée au journal | `synapse_append_journal(space_id, subject, body)` |
| Rechercher dans un espace | `synapse_search(space_id, q)` |

> `synapse_upsert_page` lit la page existante avant d'écrire (pas d'écrasement à l'aveugle).
> `synapse_append_journal` lit l'horloge système, insère en tête, gère l'unicité par jour.
> Les conventions sont encodées dans le MCP — ne pas les redéfinir ici.

ℹ️ Ce fichier ~/.claude/CLAUDE.md est lu au démarrage de chaque session Claude Code, quel que soit le projet. C'est ce qui rend le réflexe « documenter dans Synapse » automatique.

Vérifier

Démarre une session Claude Code dans n'importe quel dossier et demande :

« Quelles sont mes règles concernant Synapse ? »

Claude doit te résumer le workflow (1 projet = 1 espace, début/fin de session, etc.).

✅ Règles en place ? Passe à Initialiser un projet.