Démarrage rapide
SpecForge est un plugin pour votre outil IA qui vous aide à planifier, suivre et vérifier les fonctionnalités logicielles. Au lieu de vous répéter dans chaque chat, vous créez une spec (un plan court avec une liste "prêt") et votre IA la suit automatiquement.
Prérequis
- Node.js ≥ 22 — télécharger sur nodejs.org
- L'un des outils IA listés ci-dessous
Agents IA compatibles
SpecForge se connecte aux outils IA qui supportent le Model Context Protocol (MCP) — un standard ouvert pour les plugins IA :
| Agent | Méthode d'installation | Lien |
|---|---|---|
| Claude Desktop | Modifier le fichier de config | Anthropic |
| Claude Code | Commande claude mcp add | Anthropic |
| Cursor | Modifier ~/.cursor/mcp.json | Cursor |
| Windsurf | Modifier ~/.codeium/windsurf/mcp_config.json | Codeium |
| Gemini CLI | Modifier ~/.gemini/settings.json | |
| ChatGPT Desktop | Modifier le fichier de config — nécessite Plus ou Pro | |
| Cline (VS Code) | Paramètres Cline → MCP Servers |
Installation
Le bloc de configuration est identique pour tous les outils — seul l'emplacement du fichier change :
json
{
"mcpServers": {
"specforge": {
"command": "npx",
"args": ["-y", "specforge-mcp@latest"]
}
}
}Claude Desktop
Étape 1. Ouvrez Claude Desktop sur votre ordinateur.
Étape 2. Allez dans le menu Claude → Paramètres → onglet Développeur → cliquez sur Modifier la config.
Cela ouvre le fichier de configuration dans votre éditeur de texte. Si le fichier est vide, commencez par
{}.
Étape 3. Collez le bloc de configuration ci-dessus dans "mcpServers", enregistrez le fichier.
Étape 4. Quittez complètement et rouvrez Claude Desktop.
Étape 5. Ouvrez une nouvelle conversation — SpecForge apparaît dans le panneau des outils (🔌).
Claude Code
bash
claude mcp add specforge -- npx -y specforge-mcp@latestRedémarrez Claude Code. SpecForge sera disponible dans votre prochaine session. Documentation Claude Code →
ChatGPT Desktop
Ouvrez ou créez le fichier de configuration à :
- Mac :
~/Library/Application Support/ChatGPT/config.json - Windows :
%APPDATA%\ChatGPT\config.json
Collez le bloc dans "mcpServers", enregistrez et redémarrez ChatGPT. Nécessite ChatGPT Plus ou Pro.
Cursor
Ouvrez ou créez ~/.cursor/mcp.json et collez le bloc de configuration. Puis redémarrez Cursor. Documentation Cursor →
Windsurf
Ouvrez ou créez ~/.codeium/windsurf/mcp_config.json et collez le bloc de configuration. Puis redémarrez Windsurf. Documentation Windsurf →
Gemini CLI
Ouvrez ou créez ~/.gemini/settings.json et collez le bloc de configuration. Puis redémarrez Gemini CLI. Gemini CLI →
Cline (extension VS Code)
Dans VS Code avec Cline installé : ouvrez la barre latérale Cline → cliquez sur MCP Servers → collez le bloc. Cline →
Votre premier projet
Étape 1 — Vérifier que SpecForge fonctionne
Ouvrez une nouvelle conversation dans votre agent IA (Claude Desktop, Cursor, Windsurf, etc.) et tapez :
"Liste tous les outils specforge"
Vous devriez voir une liste de 59+ outils. Si rien n'apparaît, revenez à l'étape d'installation — l'agent a peut-être besoin d'un redémarrage complet.
Étape 2 — Initialiser votre projet
Indiquez à votre agent IA le chemin vers votre dossier de projet :
"Initialise mon projet dans /Users/votrenom/projets/mon-app avec specforge"
Remplacez /Users/votrenom/projets/mon-app par le chemin réel du dossier de votre projet.
SpecForge analyse le répertoire et détecte automatiquement votre langage, framework, gestionnaire de paquets et architecture. Il retourne un projectId (par exemple proj_abc123) — conservez-le, vous en aurez besoin ensuite.
Étape 3 — Créer votre première spec
Dites à Claude quelle fonctionnalité vous voulez construire :
"Crée une spec pour ajouter la connexion utilisateur avec Google OAuth au projet proj_abc123"
SpecForge crée une spec — un document court avec un plan étape par étape et une liste de ce que "terminé" veut vraiment dire. Tout est sauvegardé localement dans votre dossier de projet.
Étape 4 — Développer guidé par la spec
Continuez votre conversation avec votre agent IA normalement. La spec sert de contrat de développement — l'agent la lit, la suit et vérifie son travail contre elle.
Quand vous pensez que c'est terminé, validez :
"Valide la spec SPEC-001 contre le code dans /Users/votrenom/projets/mon-app/src"
Étape 5 — Détecter les dérives
Au fur et à mesure que votre base de code évolue, maintenez les specs à jour :
"Vérifie si mon implémentation correspond toujours à SPEC-001"
SpecForge indique quels critères sont couverts, lesquels manquent et ce qui a dérivé du plan initial (le "drift" — quand ce qui a été construit ne correspond plus à ce qui avait été convenu).