Configuration

SpecForge se configure via des variables d'environnement. Toute la configuration est facultative — des valeurs par défaut sensées sont fournies.

Variables d'environnement

Variable	Description	Défaut
`SDD_DATA_DIR`	Chemin où toutes les données de specs sont stockées (projets, templates, connaissances)	`./data`
`SDD_HOURLY_RATE`	Taux horaire du développeur en USD, utilisé pour l'estimation des coûts	`50`
`SDD_LOCALE`	Langue par défaut pour le contenu généré (`en`, `es`, `pt`)	`en`

Claude Desktop

Passez les variables d'environnement dans la section env de la configuration de votre serveur MCP :

json

// claude_desktop_config.json
{
  "mcpServers": {
    "specforge": {
      "command": "npx",
      "args": ["-y", "specforge-mcp@latest"],
      "env": {
        "SDD_DATA_DIR": "/Users/moi/specforge-data",
        "SDD_HOURLY_RATE": "120",
        "SDD_LOCALE": "en"
      }
    }
  }
}

Répertoire de données partagé

Si vous travaillez sur plusieurs projets, pointez SDD_DATA_DIR vers un répertoire stable en dehors de vos dossiers de projet. SpecForge stocke les données par projet dans {SDD_DATA_DIR}/projects/{hash}/ — sans collisions.

Claude Code

Définissez les variables d'environnement avant d'ajouter le serveur MCP, ou exportez-les dans votre profil shell :

bash

# Option 1 : en ligne lors de l'ajout
SDD_HOURLY_RATE=120 claude mcp add specforge npx -y specforge-mcp@latest

# Option 2 : dans votre profil shell
export SDD_HOURLY_RATE=120
export SDD_LOCALE=en

Locale

SpecForge prend en charge trois locales pour le contenu des specs générées et les messages :

Code	Langue
`en`	Anglais
`es`	Espagnol
`pt`	Portugais

Vous pouvez également changer la locale à la volée sans redémarrer :

Prompt : "Définis la locale sur es"

Cela appelle set_locale et bascule immédiatement tout le contenu généré suivant vers l'espagnol.

Stockage des données

Toutes les données sont stockées sous forme de fichiers JSON localement — sans cloud, sans compte, sans télémétrie.

{SDD_DATA_DIR}/
├── projects/
│   └── {hash}/          # Un répertoire par projet (hashé depuis le chemin du projet)
│       ├── specs/        # Toutes les specs de ce projet
│       ├── metrics/      # Métriques d'estimation et de qualité
│       ├── patterns/     # Patterns appris
│       └── knowledge/    # Contexte et documentation contribués
└── global/
    ├── templates/        # Templates de specs et de PLAN.md
    └── pricing/          # Données d'estimation de coûts

Gitignore

Ajoutez votre SDD_DATA_DIR à .gitignore s'il se trouve dans votre projet. Le répertoire ./data par défaut est typiquement spécifique au projet et ne doit pas être commité.

Taux horaire pour l'estimation

SDD_HOURLY_RATE est utilisé par estimate pour convertir les estimations en story points en plages de coût en dollars. Définissez-le au taux mixte moyen de votre équipe pour des estimations les plus précises.

# Développeur individuel
SDD_HOURLY_RATE=80

# Tarif agence
SDD_HOURLY_RATE=150

# Taux mixte équipe
SDD_HOURLY_RATE=95

Configuration ​

Variables d'environnement ​

Claude Desktop ​

Claude Code ​

Locale ​

Stockage des données ​

Taux horaire pour l'estimation ​