Forge

Verwandeln Sie Claude Code in eine strukturierte Bereitstellungsschleife: Planen Sie die Arbeit, führen Sie Module parallel aus, validieren Sie gründlich, wiederholen Sie Versuche intelligent und übernehmen Sie das, was funktioniert hat.

Installation

Kopieren und einfügen:

claude plugin marketplace add TT-Wang/forge
claude plugin install forge@tt-wang-plugins

Der erste Start kann einige Sekunden dauern, da Forge seine MCP-Server-Abhängigkeiten automatisch bootstrappt.

Nach der Installation:

1. Starten Sie Claude Code neu, falls es bereits geöffnet war

2. Öffnen Sie das Repository, in dem Sie arbeiten möchten

3. Führen Sie /forge <objective> aus

Beispiel:

/forge add audit logging for admin actions

Related MCP server: KIA - Kaizen Intelligent Agent

Das Konzept

Forge ist für den Punkt gedacht, an dem einfaches Prompting nicht mehr ausreicht.

Wenn die Aufgabe mehrere Dateien betrifft, eine Koordination zwischen Modulen erfordert oder den Nachweis erbringen muss, dass sie tatsächlich funktioniert, bietet Forge Claude Code einen Workflow anstelle eines weiteren Prompts:

• Unterteilen Sie die Arbeit in Module

• Führen Sie aus, was parallelisiert werden kann

• Validieren Sie jedes Modul streng

• Wiederholen Sie fehlgeschlagene Versuche mit Debugger-Kontext

• Merken Sie sich für die nächste Aufgabe, was funktioniert hat

Sie verwenden weiterhin Claude Code. Forge fügt lediglich Struktur um die schwierigen Teile herum hinzu.

Was Sie erhalten

• Strukturierte Planung: Unterteilt ein Feature in Module mit Abhängigkeiten und Verifizierungsbefehlen

• Parallele Ausführung: Führt unabhängige Module gleichzeitig in isolierten Worktrees aus

• Tiefe Validierung: Überprüft Dateien, Befehle, Syntax und modulübergreifende API-Verträge

• Intelligente Wiederholung: Verfolgt Versuche, erkennt Stagnation und eskaliert an einen Debugger-Agenten

• Sitzungsfortsetzung: Setzt unvollständige Arbeit fort, anstatt von vorne zu beginnen

• Sitzungsübergreifendes Gedächtnis: Merkt sich Konventionen, Fehlermuster und Testbefehle

• Sichtbarkeit des Status: Zeigt den Fortschritt in der Claude-Ausgabe und einer Terminal-Statuszeile an

Warum nicht einfach direkt Claude Code verwenden?

Für viele Aufgaben sollten Sie das tun.

Forge versucht nicht, die normale Nutzung zu ersetzen. Es ist für Aufgaben gedacht, bei denen die Orchestrierung wichtig ist.

Schnellstart

60-Sekunden-Einrichtung

1. Installieren Sie Forge mit den beiden oben genannten Befehlen

2. Starten Sie Claude Code neu

3. Öffnen Sie Ihr Projekt

4. Fügen Sie ein Ziel ein:

/forge add JWT auth with refresh tokens

5. Genehmigen Sie den generierten Plan

Ausführen

/forge build an audit log for admin actions

Fortschritt prüfen

/forge-status

Ein Modul erneut prüfen

/forge-validate m2

Eine typische Sitzung

/forge add JWT auth with refresh tokens

[forge] Phase 1: Planning...
[forge] Proposed Plan: 4 modules, 2 parallel groups
[forge] Proceed with this plan? (yes / modify / abort)

[forge] Phase 2: Executing m1...
[forge] Phase 2: Executing m2, m3 in parallel...
[forge] ✓ m2: DONE — validated, score 1.0
[forge] ✗ m3: FAILED — retrying with debugger
[forge] ✓ m3: DONE — validated after retry

[forge] ## Forge Complete
[forge] 4/4 modules completed

Das ist die Erfahrung, die Forge anstrebt: weniger manuelle Steuerung, mehr sichtbarer Fortschritt und weniger unbemerkte Fehler.

Was Sie beim ersten Lauf erwartet

• Forge erstellt ein lokales .forge/-Verzeichnis in Ihrem Projekt

• Der MCP-Server benötigt möglicherweise einige Sekunden, um seine Node-Abhängigkeiten zu installieren

• Ihre erste echte Interaktion ist der Schritt der Planüberprüfung

• Nichts wird ausgeführt, bevor Sie den Plan nicht explizit genehmigt haben

Aktuelle Projektstruktur

forge/
├── .claude-plugin/
│   ├── plugin.json
│   └── marketplace.json
├── .claude/
│   ├── settings.json
│   └── settings.local.json
├── agents/
│   ├── planner.md
│   ├── worker.md
│   ├── reviewer.md
│   └── debugger.md
├── skills/
│   ├── forge/
│   │   └── SKILL.md
│   ├── forge-status/
│   │   └── SKILL.md
│   └── forge-validate/
│       └── SKILL.md
├── forge-mcp-server/
│   ├── index.mjs
│   ├── start.sh
│   ├── package.json
│   └── tests/
├── statusline/
│   └── forge-status.sh
├── docs/
│   ├── architecture.md
│   ├── mcp-tools.md
│   └── launch/
├── CHANGELOG.md
├── CONTRIBUTING.md
├── SECURITY.md
├── CLAUDE.md
└── README.md

Zur Laufzeit erstellt Forge außerdem ein lokales .forge/-Verzeichnis im Arbeitsprojekt, um Pläne, Protokolle, Gedächtnis, Wiederholungsverlauf und den fortsetzbaren Status zu speichern.

Die Hauptkomponenten

Agenten

Forge wird mit vier spezialisierten Agenten geliefert:

• planner: untersucht die Codebasis und schlägt den Modulplan vor

• worker: implementiert ein Modul in einem isolierten Worktree

• reviewer: prüft Korrektheit, Sicherheit und Vertragsabweichungen

• debugger: untersucht fehlgeschlagene Module und steuert die Wiederholung

Fähigkeiten

Die benutzerseitigen Befehle sind:

• /forge: vollständiger Orchestrator-Workflow

• /forge-status: aktueller Plan, Modulfortschritt und gelernte Muster

• /forge-validate: erneute Validierung für ein Modul ausführen

MCP-Server

Der gebündelte MCP-Server bietet die gemeinsamen Laufzeitfunktionen, die Forge benötigt:

• validate

• validate_plan

• memory_recall

• memory_save

• iteration_state

• forge_logs

• session_state

Diese Tools ermöglichen es mehreren Agenten, sich zu koordinieren, ohne auf ein loses Konversationsgedächtnis angewiesen zu sein.

Statuszeile

Forge kann den Live-Fortschritt in Ihrem Terminal anzeigen:

[forge] ████░░░░░░ 2/5 | VALIDATE | refresh endpoint | 3m19s | ~2m30s left

Zur Verwendung:

claude statusline set "bash /path/to/forge/statusline/forge-status.sh"

Was in Ihrem Projekt verbleibt

Forge speichert seinen Laufzeitstatus in einem lokalen .forge/-Verzeichnis innerhalb des Arbeitsprojekts. Dazu gehören:

• Ausführungspläne

• Wiederholungsverlauf

• Gelernte Muster

• Strukturierte Protokolle

• Fortsetzbarer Sitzungsstatus

Dies hält den Workflow überprüfbar, anstatt alles hinter einem undurchsichtigen Agentenstatus zu verbergen.

Dokumentation

• Architektur — Orchestrator, Agenten, MCP-Server und Statusfluss

• Referenz der MCP-Tools — Eingabe-/Ausgabeschemata und Beispiele für alle 7 Tools

• Changelog — Versionshinweise

• Mitwirken — Entwicklungs-Setup, Tests, Linting und PR-Prozess

• Sicherheit — Schwachstellenmeldung und Sicherheitsumfang

Manuelle Installation

Wenn Sie nicht über den Claude Code Marketplace installieren möchten, können Sie Forge manuell einbinden:

git clone https://github.com/TT-Wang/forge.git /tmp/forge
mkdir -p .claude/agents .claude/skills
cp /tmp/forge/agents/*.md .claude/agents/
cp -r /tmp/forge/skills/* .claude/skills/
cp -r /tmp/forge/forge-mcp-server ./forge-mcp-server/
cd forge-mcp-server && npm install && cd ..

Binden Sie dann den MCP-Server mithilfe der Referenzkonfiguration in .claude/settings.json ein.

Entwicklung

git clone https://github.com/TT-Wang/forge.git
cd forge/forge-mcp-server
npm install
npm test

Funktioniert hervorragend mit

• memem — persistentes sitzungsübergreifendes Gedächtnis für Claude Code. Forge kümmert sich um Planung und Ausführung; memem hilft dabei, nützliche Muster über Läufe hinweg beizubehalten.

• Vibereader — kuratierte Tech-News, während Claude arbeitet

Lizenz

MIT — siehe LICENSE