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 生成的代码。
相关
- 项目
- 项目
- 项目
- 项目
- 项目