Das Orchestrierungs-Framework, das mehreren KI-Agenten und Menschen ermöglicht, gleichzeitig am selben Code zu arbeiten, ohne sich gegenseitig zu zerstören.
Wenn mehrere Agenten (Claude, Codex, Gemini) und Menschen gleichzeitig an einem Repository arbeiten, bricht alles zusammen.
Ohne Koordination ändern zwei Agenten dieselbe Datei. Beim Merge entsteht Chaos. Einer verliert seine Arbeit, der andere merkt es nicht einmal.
Agent A plant ein neues Auth-System, während Agent B bereits eines implementiert. Es gibt keinen Mechanismus für gegenseitige Wahrnehmung.
Ein Agent trifft eine wichtige Entscheidung in Session 1. In Session 5 weiß niemand mehr davon. Das Projekt-Gedächtnis existiert nicht.
Ohne intelligente Reihenfolge werden Branches wild gemergt. Architektur-Änderungen kollidieren mit Feature-Branches und erzeugen Kaskaden-Konflikte.
Jeder Agent arbeitet an dem, was er für wichtig hält. Es gibt keine Single Source of Truth für den Projektstatus und die Aufgabenverteilung.
Zwei Agenten können gleichzeitig dasselbe Modul bearbeiten. Es fehlt ein Mechanismus, der exklusiven Schreibzugriff garantiert.
Nexus löst jedes dieser Probleme mit einem dedizierten Mechanismus. Zusammen bilden sie ein lückenloses Orchestrierungs-System.
Jede signifikante Aktion wird automatisch aufgezeichnet. Commits, Branch-Wechsel, Planungsschritte. Git-Hooks füttern den Rekorder ohne manuellen Aufwand. Nach dem Merge wird das temporäre Wissen automatisch aufgeräumt.
# Automatisch durch Git-Hooks: ✅ Flight record #42 created [commit] Agent-B on feat/auth "Add JWT validation middleware" # Manuell abfragen: $ nexus active-work 🔄 Active Parallel Work: feat/auth | Claude | JWT middleware feat/ui | Codex | Dashboard redesign fix/perf | Human | DB query optimization
Bevor ein Agent mit der Planung beginnt, prüft er automatisch, ob seine geplante Arbeit mit laufenden Arbeiten anderer kollidiert. Der Check analysiert Datei-Überlappungen, Unit-Ownership und relevante Architektur-Entscheidungen.
$ nexus preflight --actor "Claude" --branch "feat/payments" 🚫 PRE-FLIGHT CHECK BLOCKED Critical conflicts detected. Active parallel work: 2 other branch(es) Relevant ADRs: 3 Conflicts: [CRITICAL] ownership: Unit "src/payments" claimed by Codex. Wait for release or coordinate. 📚 Relevant ADRs: ADR-001: Use Stripe for payments ADR-003: All APIs must be authenticated
Nur ein Agent kann eine Code-Einheit gleichzeitig bearbeiten. First-Writer-Wins-Semantik verhindert Race Conditions. Atomare SQLite-Operationen garantieren Konsistenz, selbst wenn mehrere Agenten gleichzeitig Claims versuchen.
$ nexus ownership claim --unit "src/auth" --actor "Claude" ✅ Unit "src/auth" claimed by Claude $ nexus ownership claim --unit "src/auth" --actor "Codex" 🚫 Unit "src/auth" is already claimed by Claude # Nach getaner Arbeit: $ nexus ownership release --unit "src/auth" --actor "Claude" ✅ Unit "src/auth" released by Claude $ nexus ownership list 🔒 Active Unit Claims: src/payments → Codex (since 14:30) src/ui/dashboard → Gemini (since 14:45)
Analysiert alle aktiven Feature-Branches, erkennt Datei-Überlappungen und berechnet die optimale Merge-Reihenfolge. Architektur-Änderungen werden priorisiert, damit nachfolgende Branches auf der neuen Basis aufbauen können.
$ nexus merge-order ⚠️ 2 potential conflict(s) detected. Recommended merge order: 1. feat/schema-migration (Score: 156) 2. feat/auth (Score: 89) 3. feat/ui-redesign (Score: 34) Conflict: feat/schema-migration ↔ feat/auth Files: src/db/schema.ts, migrations/001.sql Resolution: Merge "feat/schema-migration" FIRST, then rebase "feat/auth".
Permanentes Projekt-Wissen, das über alle Sessions und Agenten hinweg bestehen bleibt. Jeder Agent sieht bei seinem Pre-Flight Check die relevanten Architektur-Entscheidungen und kann sie in seine Planung einbeziehen.
$ nexus adr create --id ADR-005 \ --title "Use WebSocket for real-time" \ --decision "Socket.io with Redis adapter" \ --actor "Tech Lead" ✅ ADR ADR-005 created $ nexus adr accept --id ADR-005 ✅ ADR ADR-005 accepted. $ nexus adr list 📋 Architecture Decision Records: [ACCEPTED] ADR-001: Use PostgreSQL [ACCEPTED] ADR-003: JWT with 15min expiry [ACCEPTED] ADR-005: WebSocket via Socket.io [DEPRECATED] ADR-002: Use MongoDB
Eine Single Source of Truth für alle Aufgaben. Agenten claimen Items bevor sie arbeiten, sodass keine Doppelarbeit entsteht. Der Status-Workflow (NEW, READY, IN_PROGRESS, IN_REVIEW, DONE) gibt jederzeit Überblick.
$ nexus backlog add --id FEAT-07 \ --title "OAuth2 Google Login" \ --type FEAT --priority P0 ✅ Backlog item FEAT-07 created $ nexus backlog claim --id FEAT-07 --actor "Claude" ✅ Claude claimed FEAT-07 $ nexus backlog list 📋 Backlog: [P0] FEAT-07: OAuth2 Google Login (IN_PROGRESS) [Claude] [P1] FIX-03: Memory leak in worker (IN_REVIEW) [Codex] [P2] IMP-12: Refactor logger module (READY)
Nexus lebt als .nexus/ Verzeichnis in deinem Projekt. Eine einzige SQLite-Datenbank im WAL-Modus bildet das zentrale Projekt-Gedächtnis. Git-Hooks füttern es automatisch.
Dein bestehendes Repository bleibt unverändert. Nexus fügt nur Hooks hinzu.
Automatische Erfassung aller Aktivitäten ohne manuellen Aufwand.
Intelligente Koordination zwischen allen Akteuren.
SQLite (WAL Mode) als persistentes Projekt-Gedächtnis.
Jeder Agent folgt diesem standardisierten Ablauf. Fünf Schritte, die garantieren, dass parallele Arbeit reibungslos funktioniert.
Prüfe, ob deine geplante Arbeit mit laufenden Arbeiten anderer kollidiert. Lies relevante ADRs. nexus preflight --actor "Name"
Reserviere die Code-Einheiten, die du bearbeiten wirst. Damit weiß jeder andere Agent, dass dieser Bereich belegt ist. nexus ownership claim --unit "src/module"
Implementiere dein Feature oder deinen Fix. Die Git-Hooks zeichnen automatisch jeden Commit auf. Andere Agenten sehen deine Aktivität in Echtzeit.
Gib die Code-Einheiten wieder frei, damit andere Agenten sie bearbeiten können. nexus ownership release --unit "src/module"
Markiere dein Backlog-Item als IN_REVIEW oder DONE. Der Merge Orchestrator übernimmt den Rest. nexus backlog status --id FEAT-01 --status IN_REVIEW
Was sich ändert, wenn Nexus in deinem Projekt aktiv ist.
| Szenario | Ohne Nexus | Mit Nexus |
|---|---|---|
| Zwei Agenten bearbeiten dieselbe Datei | Merge-Konflikt, Datenverlust | Unit Ownership blockiert den zweiten Agent |
| Agent startet Arbeit an neuem Feature | Keine Ahnung, was andere tun | Pre-Flight zeigt alle aktiven Arbeiten |
| Architektur-Entscheidung in Session 1 | In Session 5 vergessen | ADR permanent gespeichert, im Pre-Flight sichtbar |
| 5 Branches sollen gemergt werden | Zufällige Reihenfolge, Kaskaden-Konflikte | Smart Merge berechnet optimale Reihenfolge |
| Wer arbeitet gerade woran? | Keine Transparenz | nexus status zeigt alles auf einen Blick |
| Aufgabenverteilung zwischen Agenten | Doppelarbeit, keine Koordination | Backlog mit Claim-Semantik verhindert Duplikate |
Drei Befehle. Dann ist Nexus einsatzbereit.
# 1. Repository klonen und bauen git clone https://github.com/GodModeAI2025/nexus-framework.git cd nexus-framework && pnpm install && pnpm build # 2. Global verfügbar machen npm link # 3. In deinem Projekt aktivieren cd dein-projekt nexus init --install-hooks ✅ Nexus initialized at .nexus/ ✅ Git hooks installed: post-commit, post-checkout, post-merge, pre-push # Agent-Identität setzen export NEXUS_ACTOR_NAME="Claude"