Initialiser un projet

Tout est en place ! Reste à relier chacun de tes projets à un espace Synapse. La règle d'or : 1 projet = 1 espace.

Le plus simple est d'utiliser le skill /synapse-init, qui automatise toute la mise en place.

Installer le skill /synapse-init

Le skill est un fichier Markdown à placer dans ton dossier de configuration Claude :

mkdir -p ~/.claude/skills/synapse-init
# Récupère le fichier SKILL.md auprès de l'administrateur de l'instance
# ou via le dépôt Synapse : mcp/kit/skill/synapse-init/SKILL.md

Redémarre Claude Code. La commande /synapse-init est désormais disponible.

Utiliser le skill

Ouvre une session Claude Code dans le dossier de ton projet, puis lance :

/synapse-init

Le skill va, avec ta validation à chaque étape :

1. Détecter le projet et vérifier qu'il n'est pas déjà initialisé.
2. Créer (ou retrouver) l'espace Synapse du projet.
3. Appliquer la structure de documentation commune (Architecture, API, Déploiement, Tests…).
4. Importer ta doc locale existante (README, docs/, *.md) dans les bonnes pages.
5. Écrire le pointeur Synapse: space_id=<id> dans le CLAUDE.md du projet.

Alternative — à la main

Sans le skill, tu peux faire l'essentiel manuellement. Dans une session ouverte sur ton projet :

1. Demande à Claude : « Crée l'espace Synapse pour ce projet » → il appelle synapse_resolve_project_space(name: "<NomDuProjet>", create: true) et te renvoie le space_id.

2. Ajoute le pointeur dans le CLAUDE.md à la racine du dépôt :

   > **Documentation Synapse** — `Synapse: space_id=<id-retourné>`
   

Et ensuite ?

À partir de là, dans ce projet, Claude va :

• En début de session : lire le space_id, consulter l'arbre des pages et le contexte existant avant d'agir.
• Au fil du travail : tenir à jour les pages impactées (architecture, API, déploiement…).
• En fin de session : ajouter une entrée au journal (synapse_append_journal).

🎉 Tu utilises Synapse exactement comme prévu. Bonne doc !

Besoin d'aide ? Va voir la page Dépannage.