SpecForge

🇩🇪 Deutsch

🇺🇸 English
🇪🇸 Español
🇧🇷 Português
🇫🇷 Français
🇨🇳 中文

🇩🇪 Deutsch

🇺🇸 English
🇪🇸 Español
🇧🇷 Português
🇫🇷 Français
🇨🇳 中文

Appearance

Erste Schritte ​

SpecForge ist ein Plugin für dein KI-Tool, das dir hilft, Software-Funktionen zu planen, zu verfolgen und zu überprüfen. Statt dich in jedem Chat zu wiederholen, erstellst du eine Spec (ein kurzer Plan mit einer "fertig"-Checkliste) und deine KI folgt ihr automatisch.

Voraussetzungen ​

Kompatible KI-Agenten ​

SpecForge verbindet sich mit KI-Tools, die das Model Context Protocol (MCP) unterstützen — ein offener Standard für KI-Plugins:

AgentInstallationsmethodeLink
Claude DesktopKonfigurationsdatei bearbeitenAnthropic
Claude CodeBefehl claude mcp addAnthropic
Cursor~/.cursor/mcp.json bearbeitenCursor
Windsurf~/.codeium/windsurf/mcp_config.json bearbeitenCodeium
Gemini CLI~/.gemini/settings.json bearbeitenGoogle
ChatGPT DesktopKonfigurationsdatei bearbeiten — erfordert Plus oder Pro
Cline (VS Code)Cline-Einstellungen → MCP Servers

Installation ​

Der Konfigurationsblock ist für alle Tools gleich — nur der Dateipfad ändert sich:

json
{
  "mcpServers": {
    "specforge": {
      "command": "npx",
      "args": ["-y", "specforge-mcp@latest"]
    }
  }
}

Claude Desktop ​

Schritt 1. Claude Desktop auf deinem Computer öffnen.

Schritt 2. Zum Menü Claude → Einstellungen → Tab Entwickler → auf Konfiguration bearbeiten klicken.

Damit wird die Konfigurationsdatei in deinem Texteditor geöffnet. Wenn die Datei leer ist, beginne mit {}.

Schritt 3. Den obigen Konfigurationsblock innerhalb von "mcpServers" einfügen und die Datei speichern.

Schritt 4. Claude Desktop vollständig beenden und neu öffnen.

Schritt 5. Eine neue Konversation öffnen — SpecForge erscheint im Tools-Panel (🔌).

Claude Code ​

bash
claude mcp add specforge -- npx -y specforge-mcp@latest

Claude Code neu starten. SpecForge ist in deiner nächsten Sitzung verfügbar. Claude Code Dokumentation →

ChatGPT Desktop ​

Öffne oder erstelle die Konfigurationsdatei unter:

  • Mac: ~/Library/Application Support/ChatGPT/config.json
  • Windows: %APPDATA%\ChatGPT\config.json

Füge den Konfigurationsblock in "mcpServers" ein, speichere und starte ChatGPT neu. Erfordert ChatGPT Plus oder Pro.

Cursor ​

~/.cursor/mcp.json öffnen oder erstellen und den Konfigurationsblock einfügen. Dann Cursor neu starten. Cursor Dokumentation →

Windsurf ​

~/.codeium/windsurf/mcp_config.json öffnen oder erstellen und den Konfigurationsblock einfügen. Dann Windsurf neu starten. Windsurf Dokumentation →

Gemini CLI ​

~/.gemini/settings.json öffnen oder erstellen und den Konfigurationsblock einfügen. Dann Gemini CLI neu starten. Gemini CLI →

Cline (VS Code-Erweiterung) ​

In VS Code mit installiertem Cline: Cline-Seitenleiste öffnen → MCP Servers klicken → Block einfügen. Cline →

Dein erstes Projekt ​

Schritt 1 — Prüfe, ob SpecForge funktioniert ​

Öffne einen neuen Chat in deinem KI-Agenten (Claude Desktop, Cursor, Windsurf usw.) und tippe:

"List all specforge tools"

Du solltest eine Liste von 59+ Tools sehen. Wenn nichts erscheint, gehe zurück zum Installationsschritt — der Agent benötigt möglicherweise einen vollständigen Neustart.

Schritt 2 — Initialisiere dein Projekt ​

Teile deinem KI-Agenten den Pfad zu deinem Projektordner mit:

"Initialize my project at /Users/deinname/projects/meine-app with specforge"

Ersetze /Users/deinname/projects/meine-app mit dem tatsächlichen Ordnerpfad deines Projekts.

SpecForge scannt das Verzeichnis und erkennt automatisch deine Sprache, dein Framework, deinen Paketmanager und deine Architektur. Es gibt eine projectId zurück (z.B. proj_abc123) — merke dir diese, du brauchst sie im nächsten Schritt.

Schritt 3 — Erstelle deine erste Spec ​

Teile Claude mit, welche Funktion du bauen möchtest:

"Create a spec for adding user login with Google OAuth to project proj_abc123"

SpecForge erstellt eine Spec — ein kurzes Dokument mit einem schrittweisen Plan und einer Checkliste, was "fertig" bedeutet. Alles wird lokal in deinem Projektordner gespeichert.

Schritt 4 — Entwickle geführt durch die Spec ​

Führe deine Konversation mit deinem KI-Agenten wie gewohnt fort. Die Spec fungiert als Entwicklungsvertrag — der Agent liest sie, folgt ihr und überprüft seine Arbeit daran.

Wenn du glaubst, dass es fertig ist, validiere:

"Validate spec SPEC-001 against the code at /Users/deinname/projects/meine-app/src"

Schritt 5 — Erkenne Abweichungen ​

Wenn sich deine Codebasis weiterentwickelt, halte Specs synchron:

"Check if my implementation still matches SPEC-001"

SpecForge berichtet, welche Kriterien abgedeckt sind, welche fehlen und was vom ursprünglichen Plan abgewichen ist („Drift" — wenn das Gebaute nicht mehr zum ursprünglich Vereinbarten passt).

Nächste Schritte ​