VibeFrame

エージェンティックコーディングのためのコントロールプレーン。 VibeFrame は、ソフトウェアがあるべき姿（ビジネス意図、システム設計、そしてコード自体）の生きたリポジトリ内モデルを維持し、それを現実と決定的に同期させ、乖離が生じた場所を示します。

コーディングエージェントは、誰も読めない速度でコードを書きます。蒸発するのは理論です。何が存在するのか、なぜ存在するのか、どの決定が耐荷重なのか、そしてコードが決定事項と一致しているかどうか。VibeFrame は、その理論を最も安価に捕捉できる瞬間（計画時、エージェント自身の MCP プロトコルを通じて）に捕捉し、リポジトリ内のプレーンファイルとして保存し、機械的に永久に検証し、タスクスコープのコンテキストブリーフでエージェントに報います。これはコードベースを再 grep するよりも優れています。

• 3つの平面、1つのグラフ — 機能とワークフロー（意図）、コンポーネントと制約（システム）、ファイルとシンボル（コード、100% 派生 — 推測は一切なし）。

• すべての事実に信頼ティア — A 派生 / B 拡張 / C 表明。陳腐化は可視化され、決して黙殺されません。

• 証拠付きのドリフト検出 — 生きたリフレクションモデル：乖離、欠落、壊れたバインディング、孤立、循環、ロックされた決定へのタッチ。LLM 呼び出しはゼロ。フレームワークは決定的であり、コーディングエージェントがインテリジェンスです。

• リポジトリ内モデル — .vibeframe/ YAML/Markdown は git でバージョン管理：ブランチセーフ、PR レビュー可能、あらゆるツールで生存可能。gitignore された SQLite インデックスは派生され、再構築可能です。

• プロジェクトごとに1つのデーモン — Streamable-HTTP MCP エンドポイント、REST + SSE、そしてライブブラウザ UI（Map、Focus、Inspector、Activity、Drift インボックス、Decisions）を単一プロセスで提供。

• Claude Code ファースト — プラグインが MCP サーバー、決定的フック、スキルをバンドル。モデルは AGENTS.md ダイジェストを通じて任意のエージェントにもサービスを提供します。

インストール (v0.1.0 — まだ npm にはありません)

リリース tarball を GitHub から直接プロジェクトにインストールします（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

（またはクローンから：npm ci && npm run build && npm pack --workspaces を実行し、tarball を npm i -D します。npm i vibeframe は実行しないでください — その名前は現在レジストリ上の無関係なパッケージに属しています。）

Related MCP server: Paparats MCP

クイックスタート

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)

完全な Claude Code エクスペリエンス（MCP プラス決定的フックと /vibeframe:* コマンド）を利用するには、このリポジトリから Claude Code 内でプラグインをインストールします — /plugin marketplace add jubayertalha/vibeframe を実行し、次に /plugin install vibeframe を実行します。上記の claude mcp add 行はスキップしてください（プラグインがサーバーを提供します）。

次に、エージェントに機能の計画を依頼します。エージェントは 1 回の vibe_context 呼び出しで方向付けを行い、コーディング前にワークフローを宣言し、実装後にバインディングを行います。そして、エージェントが忘れたものはすべて、決定的レイヤーが捕捉します：違反は同じターン内の警告として返され、説明のない変更は調整のためにキューに入れられ、ドリフトインボックスは現実が計画から逸脱した正確な場所を file:line の証拠付きで示します。完全なウォークスルー： docs/getting-started.md。

ドキュメント

ステータス

v0.1.0 — グリーンフィールドの TypeScript/JavaScript/Python プロジェクトでの完全なループ：init → declare → index → link → validate → reconcile。デーモン、MCP ツール、フック、6レンズ UI を備えています。設計上延期されています（Discovery を参照）：他のエージェントアダプター、ブラウンフィールド採用モード、シンボルレベルのコールグラフ、チーム、ホスト型サービス。

開発

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

docs/contributing/development.md と CLAUDE.md を参照してください。

ライセンス

MIT