kaanozhan/Frame

ADE( Agentic Development Environment) The spec-driven environment for AI coding agents, where your planning becomes lasting, shared project context.

Frame – 仕様駆動型、AIオーケストレーション開発環境

概要 – Frameは、AIコーディングエージェントに永続的でgitアンカーされたコンテキストを提供するElectronベースのデスクトップIDEです。任意のプロジェクトに標準的な.frame/フォルダを作成し、以下を保存します：

AGENTS.md – エージェントが自動的に読み取るプロジェクト全体のルール
STRUCTURE.json – モジュールの高速インテントインデックス
PROJECT_NOTES.md – セッション間で維持されるアーキテクチャ上の決定事項
tasks.json – 共有タスクボード
specs/ – マークダウンベースの仕様 → 計画 → タスク → 成果物ワークフロー

このツールは、セッション開始時に.frame/AGENTS.mdファイルを注入することで、Claude Code、Codex CLI、Gemini CLI（および将来のAI CLI）と連携します。これにより、すべてのエージェントが同じプロジェクト知識から開始します。

基本概念

概念	Frameでの利用方法
Gitコミットをコンテキストアンカーとして	プリコミットフックが`STRUCTURE.json`、`tasks.json`、`PROJECT_NOTES.md`を更新します。新しいAIセッションを開始すると、エージェントはこれらのファイルを読み取り、何が変更され、なぜ変更されたかを正確に把握することを保証します。
仕様駆動型開発	各機能は`.frame/specs/<slug>/`内に4つのマークダウンファイル（spec, plan, tasks, outcome）とともに存在します。AIは計画を生成（`/spec.plan`）、タスクに分解（`/spec.tasks`）、実装（`/spec.implement`）できます。各タスクの後、エージェントは短い成果物メモを書き、何が構築されたかのストーリーを保持します。
エージェントオーケストレーション	conductorエージェントが準備完了の仕様を並列で実行し、それぞれは独自のgit worktree（`.frame/worktrees/<slug>`）内で動作します。フットプリント分析により重複するファイル変更を防ぎ、完了した作業は人間の承認後にのみマージされます。
高速ファイル検索	`STRUCTURE.json`には、概念をソースファイルにマッピングする`intentIndex`が含まれています。`node scripts/find-module.js github`のようなスクリプトは、関連するファイルを即座に返し、AIがリポジトリ全体をスキャンする手間を省きます。

主な機能

マルチターミナルグリッド – 1つのウィンドウ内で最大9つの実PTYターミナル、リサイズ可能なレイアウト。
タスク＆仕様パネル – ビジュアルボード；タスクは選択したAIツールに直接送信可能。
GitHub統合 – サイドバーからイシュー、PR、ブランチ、ラベルを表示。
並列仕様実行 – 隔離されたgit worktree、仕様ごとのブランチ、マージ前の自動ドリフトチェック。
マルチAI対応 – Claude Code（ネイティブ）、Codex CLI（ラッパー）、Gemini CLI（ラッパー）。ツールを切り替えてもプロジェクトファイルは失われません。
プリコミットフック – モジュールマップとタスク状態を自動的に同期。
拡張可能なプラグイン – Claude Codeプラグインの有効/無効を切り替えるパネル；マーケットプレイスの計画あり。

典型的なワークフロー

フォルダを初期化 – Frameが.frame/構造を作成。
AIセッションを開始 – Claude、Codex、またはGeminiを選択；エージェントがプロジェクトルールを読み込み。
仕様を作成 – spec.mdが機能を記述；AIがplan.mdを起草。
タスクを生成 – /spec.tasksがtasks.jsonにデータを投入。
オーケストレーション – conductorが並列worktreeで複数の仕様を実行；パイプラインレールを監視。
承認 – ドリフトチェック後、仕様のブランチをマージまたはPRを開く。
コミット – プリコミットフックがコンテキストファイルを更新し、次のセッションをアンカー。

対象ユーザー

LLMベースのコード生成に依存するチームで、再現可能でバージョン管理されたコンテキストが必要な場合。
大規模コードベースを構築する開発者で、各新しいAIセッションにアーキテクチャを再説明することがボトルネックになっている場合。
プロダクトマネージャーやテクニカルライターで、git内に保持されるマークダウンファーストの仕様、計画、成果物の記録を希望する場合。

インストール＆クイックスタート

# clone and install
git clone https://github.com/kaanozhan/Frame.git
cd Frame
npm install
npm run dev   # launches the Electron app in dev mode

macOS、Windows、Linux用のプレビルドバイナリもリリースページで提供されています。Node 16+、npm、およびサポート対象のAI CLIの少なくとも1つが必要です。

ライセンス

Apache-2.0 – 商用・非商用利用ともに無料。

結論 – Frameは、LLM支援コーディングの混沌としたステートレスな性質を、規律あるgitアンカー型ワークフローに変える具体的なオープンソースツールです。すべてのツール（またはチームメイト）が読み取れるプレーンマークダウンファイルに計画、仕様、決定事項を保持しつつ、AI生成コードの並列で安全な実行のためのUIを提供します。