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 是一款基於 Electron 的桌面 IDE，為 AI 編碼代理提供持久化且基於 Git 錨定的上下文。它在任何專案中建立一個標準的 .frame/ 資料夾，儲存以下內容：
- AGENTS.md – 代理自動讀取的專案級規則
- STRUCTURE.json – 模組的快速意圖索引
- PROJECT_NOTES.md – 跨工作階段保留的架構決策
- tasks.json – 共享任務板
- specs/ – 基於 Markdown 的規格 → 計畫 → 任務 → 結果工作流
該工具透過在會話開始時注入 .frame/AGENTS.md 檔案，從而與 Claude Code、Codex CLI、Gemini CLI（以及未來的任何 AI CLI）協同工作，確保每個代理都以相同的專案知識開始工作。
核心概念
| 概念 | Frame 如何使用它 |
|---|---|
| Git 提交作為上下文錨點 | 預提交掛鉤會更新 STRUCTURE.json、tasks.json 和 PROJECT_NOTES.md。當您啟動新的 AI 會話時，代理會讀取這些檔案，確保它確切知道發生了什麼變化以及原因。 |
| 規格驅動開發 | 每個功能都位於 .frame/specs/<slug>/ 中，包含四個 Markdown 檔案（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 掃描整個儲存庫。 |
主要功能
- 多終端網格 – 單一視窗中最多 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 會話重新解釋架構成為瓶頸。
- 希望擁有 Markdown 優先的規格、計畫和結果記錄的產品經理或技術寫作者，且該記錄保留在 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。
授權條款
Apache-2.0 – 免費用於商業和非商業用途。
總結 – Frame 是一個具體的開源工具，它將 LLM 輔助編碼的混亂和無狀態特性轉變為有紀律的、基於 Git 錨定的工作流。它允許您將計畫、規格和決策保存在任何工具（或團隊成員）都可以讀取的純 Markdown 檔案中，同時提供 UI 以並行、安全地執行 AI 生成的程式碼。
相關
- 專案
- 專案
- 專案
- 專案
- 專案