VibeFrame

Eine Steuerungsebene für agentisches Programmieren. VibeFrame pflegt ein lebendiges, im Repository liegendes Modell dessen, was Ihre Software sein soll – Geschäftsabsicht, Systemdesign und der Code selbst – hält es deterministisch mit der Realität synchron und zeigt Ihnen, wo sie auseinanderdriften.

Programmieragenten schreiben Code schneller, als irgendjemand ihn lesen kann. Was verdunstet, ist die Theorie: was existiert, warum es existiert, welche Entscheidungen tragend sind und ob der Code noch dem entspricht, was entschieden wurde. VibeFrame erfasst diese Theorie in dem Moment, in dem sie am günstigsten zu erfassen ist (zur Planungszeit, über das eigene MCP-Protokoll des Agenten), speichert sie als einfache Dateien in Ihrem Repository, verifiziert sie mechanisch für immer und zahlt dem Agenten mit aufgabenbezogenen Kontext-Briefings zurück, die besser sind als erneutes Durchsuchen des Codebasis.

• Drei Ebenen, ein Graph – Fähigkeiten & Workflows (Absicht), Komponenten & Constraints (System), Dateien & Symbole (Code, zu 100 % abgeleitet – nie geraten).

• Vertrauensstufen für jede Tatsache – A abgeleitet / B angereichert / C behauptet; Veraltung ist sichtbar, nie still.

• Drift-Erkennung mit Beweisen – ein lebendiges Reflexionsmodell: Divergenz, Abwesenheit, gebrochene Bindungen, Waisen, Zyklen, Berührungen gesperrter Entscheidungen. Null LLM-Aufrufe; das Framework ist deterministisch und der Programmieragent ist die Intelligenz.

• Im Repository liegendes Modell – .vibeframe/ YAML/Markdown, versioniert durch git: branch-sicher, PR-prüfbar, überlebt jedes Werkzeug. Ein gitignorierter SQLite-Index wird abgeleitet und ist neu aufbaubar.

• Ein Daemon pro Projekt – Streamable-HTTP-MCP-Endpunkt, REST + SSE und eine Live-Browser-UI (Karte, Fokus, Inspektor, Aktivität, Drift-Posteingang, Entscheidungen) in einem einzigen Prozess.

• Claude Code zuerst – ein Plugin bündelt den MCP-Server, deterministische Hooks und Fähigkeiten; das Modell bedient auch jeden Agenten über eine AGENTS.md-Zusammenfassung.

Installation (v0.1.0 – noch nicht auf npm)

Installieren Sie die Release-Tarballs direkt von GitHub in Ihr Projekt (Node ≥ 22.12):

npm i -D https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-core-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-store-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-indexer-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-engine-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-daemon-0.1.0.tgz

(Oder aus einem Klon: npm ci && npm run build && npm pack --workspaces, dann npm i -D die Tarballs. Tun Sie nicht npm i vibeframe – dieser Name gehört derzeit zu einem unabhängigen Paket in der Registry.)

Related MCP server: OpenLore

Schnellstart

npx vibeframe init                              # scaffold .vibeframe/ — commit it
claude mcp add vibeframe -- npx vibeframe mcp   # or install the Claude Code plugin (below)
npx vibeframe start                             # daemon + browser UI (prints the URL)

Für das vollständige Claude-Code-Erlebnis (MCP plus deterministische Hooks und die /vibeframe:*-Befehle) installieren Sie das Plugin aus diesem Repository in Claude Code – /plugin marketplace add jubayertalha/vibeframe dann /plugin install vibeframe – und überspringen Sie die claude mcp add-Zeile oben (das Plugin bringt den Server mit).

Bitten Sie dann Ihren Agenten, eine Funktion zu planen. Er orientiert sich mit einem vibe_context-Aufruf, deklariert den Workflow vor dem Programmieren, bindet Implementierungen danach – und alles, was er vergisst, fängt die deterministische Schicht ab: Verstöße kommen als Warnungen in derselben Runde zurück, unerklärte Änderungen werden zur Abstimmung eingereiht, und der Drift-Posteingang zeigt genau, wo die Realität den Plan verlassen hat, mit Datei:Zeilen-Beweisen. Vollständiger Durchlauf: docs/getting-started.md.

Dokumentation

Status

v0.1.0 – die vollständige Schleife für Greenfield-TypeScript/JavaScript/Python-Projekte: init → deklarieren → indizieren → verknüpfen → validieren → abstimmen, mit dem Daemon, MCP-Werkzeugen, Hooks und der Sechs-Linsen-UI. Bewusst aufgeschoben (siehe die Discovery): Adapter für andere Agenten, Brownfield-Übernahmemodus, Symbol-Ebene-Aufrufgraphen, Teams, alles Gehostete.

Entwicklung

npm ci && npm run build && npm run check   # lint + typecheck + unit tests
npm run test:dogfood                       # the full-loop acceptance suite

Siehe docs/contributing/development.md und CLAUDE.md.

Lizenz

MIT