Konfiguration

SpecForge wird über Umgebungsvariablen konfiguriert. Die gesamte Konfiguration ist optional — sinnvolle Standardwerte sind vorgegeben.

Umgebungsvariablen

Variable	Beschreibung	Standard
SDD_DATA_DIR	Pfad, unter dem alle Spec-Daten gespeichert werden (Projekte, Vorlagen, Wissen)	./data
SDD_HOURLY_RATE	Entwickler-Stundensatz in USD, wird für Kostenschätzungen verwendet	50
SDD_LOCALE	Standardsprache für generierten Inhalt (en, es, pt)	en

Claude Desktop

Umgebungsvariablen im Abschnitt env deiner MCP-Server-Konfiguration übergeben:

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

Gemeinsames Datenverzeichnis

Wenn du über mehrere Projekte hinweg arbeitest, zeige SDD_DATA_DIR auf ein stabiles Verzeichnis außerhalb deiner Projektordner. SpecForge speichert projektspezifische Daten unter {SDD_DATA_DIR}/projects/{hash}/ — keine Kollisionen.

Claude Code

Umgebungsvariablen vor dem Hinzufügen des MCP-Servers setzen oder in deinem Shell-Profil exportieren:

# Option 1: inline beim Hinzufügen
SDD_HOURLY_RATE=120 claude mcp add specforge npx -y specforge-mcp@latest

# Option 2: in deinem Shell-Profil
export SDD_HOURLY_RATE=120
export SDD_LOCALE=en

Spracheinstellung

SpecForge unterstützt drei Spracheinstellungen für generierten Spec-Inhalt und Nachrichten:

Code	Sprache
en	Englisch
es	Spanisch
pt	Portugiesisch

Du kannst die Sprache auch zur Laufzeit ändern, ohne neu zu starten:

Prompt: "Set locale to es"

Das ruft set_locale auf und wechselt sofort alle nachfolgend generierten Inhalte auf Spanisch.

Datenspeicherung

Alle Daten werden als lokale JSON-Dateien gespeichert — keine Cloud, keine Konten, keine Telemetrie.

{SDD_DATA_DIR}/
├── projects/
│   └── {hash}/          # Ein Verzeichnis pro Projekt (gehasht aus dem Projektpfad)
│       ├── specs/        # Alle Specs für dieses Projekt
│       ├── metrics/      # Schätzungs- und Qualitätsmetriken
│       ├── patterns/     # Gelernte Muster
│       └── knowledge/    # Beigetragener Kontext und Dokumentation
└── global/
    ├── templates/        # Spec- und PLAN.md-Vorlagen
    └── pricing/          # Kostenschätzungsdaten

Gitignore

Füge dein SDD_DATA_DIR zu .gitignore hinzu, wenn es sich innerhalb deines Projekts befindet. Das standardmäßige ./data-Verzeichnis ist typischerweise projektspezifisch und sollte nicht committet werden.

Stundensatz für Schätzungen

SDD_HOURLY_RATE wird von estimate verwendet, um Story-Point-Schätzungen in Dollar-Kostenbereiche umzurechnen. Setze es auf den durchschnittlichen gemischten Satz deines Teams für die genauesten Schätzungen.

# Einzelentwickler
SDD_HOURLY_RATE=80

# Agentur-Satz
SDD_HOURLY_RATE=150

# Team-Mischsatz
SDD_HOURLY_RATE=95