GAAI Framework Vibe 项目

项目简介

GAAI Framework（Governed Agentic AI Framework）将 AI 编码工具转化为可靠的软件交付系统。它的核心理念非常直接：只需在任意 Git 项目中放入一个 .gaai/ 文件夹，Discovery 负责定义「要做什么」，Delivery 负责执行「怎么做」，两者通过结构化 backlog 传递需求，全程无需 SDK、无需安装包、纯 Markdown + YAML + bash 实现。

核心功能

• 双模式隔离执行：Discovery 推理阶段在当前会话中运行，Delivery 执行阶段在独立 OS 进程中运行（tmux + claude -p），上下文窗口完全隔离，防止提示词污染
• 结构化 Backlog 契约：Discovery 生成 Epic + Story（含验收标准），Delivery 据此执行并验证，两者通过 backlog 传递而非共享上下文，消除范围漂移
• 三阶段 QA 门禁：Planning Sub-Agent 制定计划 → Implementation Sub-Agent 实现代码 → QA Sub-Agent 验证所有验收标准，全部通过才标记完成
• 后台守护进程：/gaai-daemon 启动交付守护进程，持续轮询 backlog 并行执行多个 Story，每个 Story 独立 tmux 会话
• 跨会话记忆：.gaai/ 文件夹携带项目上下文，Agent 重启后依然知道此前决定了什么，防止每次新建会话「失忆」
• 零依赖接入：无需 pip install、无需 npm 包，Drop into any git project，Python runtime 和 Node helper 均打包在仓库内
• 多 Agent 工具兼容：Claude Code、Codex CLI、Gemini CLI、Cursor、Windsurf 等主流 AI 编码工具均可使用 GAAI 治理层

技术实现

GAAI 的技术实现围绕「治理」展开，而非构建另一个 Agent 框架：

Backlog 即契约：Discovery 输出的 Story 含验收标准（可测试），存储在 .gaai/backlog.yaml 中。Delivery 读取该文件执行，执行结果与标准比对，QA 通过才合入。backlog 是两阶段之间唯一的传递介质。

进程级隔离：Discovery 在当前会话运行（共享上下文），Delivery 使用 claude -p 在独立 tmux session 中运行——完全不同的 OS 进程，系统提示词不共享，不会出现「Agent 越界修改不该碰的代码」问题。

子 Agent 协同：Delivery 内置 Planning / Implementation / QA 三个子 Agent，Planning 制定执行计划，Implementation 执行代码变更，QA 验证所有验收标准，三者顺序执行、结果作为下一阶段输入。

无状态设计：.gaai/ 文件夹可提交到 Git，团队成员 clone 后即可在同一套治理规则下工作，决策不丢失、上下文可传递。

快速上手

第一步：克隆项目并初始化

cd your-project git init # 如果还不是 Git 仓库 git clone https://github.com/digipulse-engineering/GAAI-framework.git export PATH="$PWD/GAAI-framework/bin:$PATH"

第二步：放置 .gaai/ 文件夹

cp -r GAAI-framework/.gaai-template/ .gaai/

第三步：用 Discovery 定义需求

在 Claude Code / Codex CLI 中运行： /gaai-discover

输入自然语言需求，例如： 「Add rate limiting — 100 req/min per user, 429 on exceeded.」

Discovery 生成 Epic E03 + Story E03S01（含验收标准），写入 backlog。

第四步：执行交付

/gaai-deliver # 当前会话单次交付 /gaai-daemon # 启动后台守护进程，持续交付 backlog 中所有 Story

守护进程实时输出到 tmux，可随时 attach 查看进度。

查看文档：

cat GAAI-framework/docs/guides/quick-start.md

适用人群

• 遭遇过「Agent 改了我不该改的代码」的开发者：GAAI 用进程隔离 + 范围门禁解决这个问题
• 追求交付确定性的团队：Story 含验收标准，QA 自动验证，交付物可追溯
• 习惯 Vibe Coding 但需要治理的工程师：不阻止用 AI 写代码，但要求每一步都有据可查
• 独立开发者 / solo 创始人：清楚自己要做什么，需要 Agent 高效执行不跑偏
• 中小团队：想引入 AI 编程但担心失控，GAAI 提供了轻量 governance 无需引入复杂框架

官方链接

• GitHub：https://github.com/digipulse-engineering/GAAI-framework
• 文档：https://github.com/digipulse-engineering/GAAI-framework/blob/main/docs/guides/quick-start.md