Forge

License: MIT Node Glama

Strukturierte Planung, parallele Ausführung und tiefgreifende Validierung für Claude Code.

Installation

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

Was es tut

Forge verwandelt ein vages Ziel in strukturierte, validierte und parallele Arbeit. Sie sagen /forge add JWT auth with refresh tokens und es plant, führt die Arbeit in parallelen Worktrees aus, validiert tiefgreifend, führt intelligente Wiederholungsversuche durch und lernt für das nächste Mal.

Plant — unterteilt Aufgaben in einen Abhängigkeitsgraphen von Modulen
Führt aus — parallele Worker in isolierten Git-Worktrees
Validiert — Syntaxprüfungen, API-Vertragsverifizierung, Erkennung von Stagnation
Wiederholt — Debugger-Agent mit Ursachenanalyse bei Fehlern
Überprüft — Korrektheits- und Sicherheitsprüfungen mit Vertragsverifizierung
Lernt — speichert Konventionen und Fehlermuster im Speicher
Setzt fort — macht nach einem Absturz genau dort weiter, wo Sie aufgehört haben

Verwendung

/forge add JWT authentication with refresh tokens
/forge-status
/forge-validate m2

Verwenden Sie Forge für dateiübergreifende Funktionen, Aufgaben, die eine Validierung erfordern, und ambitionierte Änderungen. Überspringen Sie es bei schnellen Bearbeitungen oder einfachen Fragen — verwenden Sie dafür einfach direkt Claude Code.

Funktionsweise

┌─────────────────────────────────────────────────────────────┐
│  /forge "add JWT auth with refresh tokens"                   │
└──────────────────────────┬──────────────────────────────────┘
                           │
                           ▼
              ┌────────────────────────┐
              │    Forge Orchestrator   │
              │    skills/forge/SKILL   │
              └─────┬──────────────────┘
                    │
    ┌───────────────┼───────────────┬───────────────┐
    ▼               ▼               ▼               ▼
┌────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐
│Planner │   │ Worker   │   │ Reviewer │   │ Debugger │
│        │   │ (×N      │   │          │   │          │
│ Explore│   │ parallel)│   │ Security │   │ Root     │
│ codebase   │          │   │ + API    │   │ cause    │
│ → DAG  │   │ Isolated │   │ contract │   │ analysis │
│ plan   │   │ worktree │   │ checks   │   │ + logs   │
└────┬───┘   └────┬─────┘   └────┬─────┘   └────┬─────┘
     │            │               │               │
     └────────────┴───────┬───────┴───────────────┘
                          │
                          ▼
              ┌────────────────────────┐
              │     MCP Server         │
              │     (Node.js, 7 tools) │
              │                        │
              │  validate              │
              │  validate_plan         │
              │  memory_recall/save    │
              │  iteration_state       │
              │  forge_logs            │
              │  session_state         │
              └───────────┬────────────┘
                          │
                          ▼
              ┌────────────────────────┐
              │   .forge/ (persistent) │
              │                        │
              │   plans/    memory/    │
              │   iterations/  logs/   │
              │   state/               │
              └────────────────────────┘

4 Agenten + 1 MCP-Server (7 Tools) + 3 Slash-Befehle. Alles Markdown und Node.js — keine benutzerdefinierte Laufzeitumgebung.

MCP-Tools

Tool	Was
`validate`	Syntaxprüfungen, API-Verträge, Analyse von Stagnation/Geschwindigkeit/Oszillation
`validate_plan`	DAG-Zykluserkennung, Warnungen bei Dateiüberschneidungen, Schema-Validierung
`memory_recall`	Projekt- und globalen Speicher durchsuchen
`memory_save`	Gelernte Muster mit Deduplizierung dauerhaft speichern
`iteration_state`	Wiederholungsversuche pro Modul verfolgen
`forge_logs`	Strukturierte JSONL-Logs nach Lauf, Modul, Phase, Schweregrad abfragen
`session_state`	Sitzungsstatus für Wiederaufnehmbarkeit speichern/laden

Entwicklung

Siehe CONTRIBUTING.md für die Entwicklungseinrichtung, Testbefehle und den PR-Prozess. Siehe SECURITY.md für Informationen darüber, wie Sicherheitslücken privat gemeldet werden können.

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

Dokumentation

Architektur — Orchestrator, Agenten, MCP-Server, Status
Referenz der MCP-Tools — Eingabe-/Ausgabeschemata für alle 7 Tools
Changelog — Versionshinweise

Funktioniert hervorragend mit

memem — Persistenter sitzungsübergreifender Speicher für Claude Code. Forge + memem ist die empfohlene Kombination: Forge plant und führt aus, memem merkt sich, was über verschiedene Läufe hinweg funktioniert hat. Muster, die Forge über memory_save speichert, landen im Abrufindex von memem, sodass der Lauf in der nächsten Woche bereits mit den Lektionen der letzten Woche beginnt.

Siehe auch

Vibereader — Kuratierte Tech-News, während Claude arbeitet

Lizenz

MIT — siehe LICENSE

forge