GAAI（Governed Agentic AI Infrastructure）是一个面向 AI 编程工具的治理框架，目标是把 AI 编程工具变成可靠的智能体软件交付系统。它以一个 .gaai/ 文件夹的形式放入任意 Git 项目，内容由 Markdown、YAML 和 bash 组成，并内置一个 vendored Python 运行时和少量 Node 辅助脚本。官方强调：没有 SDK、没有需要安装的包、没有外部服务，安装时不会拉取任何东西。
用途与解决的问题 AI 编程工具速度很快，但缺乏治理时，速度会带来漂移：代理会触碰不该改的代码、忘记之前会话的决策、交付无法对照验收标准验证的功能。GAAI 为这类工具补上缺失的治理层，适合已经对产品有清晰认知的开发者——独立创始人、资深工程师、小型团队，他们知道要构建什么，需要一个可靠执行而不跑偏的代理。
主要能力：Discovery 与 Delivery 双轨 Discovery：在当前会话中与 Discovery Agent 对话，澄清要构建什么，输出是 backlog 中带有验收标准的 Story。Discovery 只推理，不执行。 Delivery：始终在隔离进程中运行。/gaai-daemon 启动 Delivery Daemon，通过 tmux 为每个 Story 运行独立的 claude -p 会话——完全独立的操作系统进程，没有 Discovery 残留，也没有对话历史串扰。Delivery Agent 为每个 Story 编排专门的子代理（Planning、Implementation、QA）。可通过 tmux attach 实时查看。官方称：不即兴发挥、不范围漂移、不上下文污染。 backlog 是两者之间的契约，不在 backlog 中的内容不会被构建。
使用方式 安装：从 GitHub 下载，将 .gaai/ 文件夹复制到项目根目录，然后告诉 AI 工具：“Read .gaai/core/README.md and bootstrap this project.” 安装器会复制 .gaai/ 并为你的工具部署对应适配器（CLAUDE.md、AGENTS.md 或 .cursor/rules/）。 两个斜杠命令：/gaai-deliver 在当前会话交付单个 Story；/gaai-daemon 启动后台守护进程，轮询 backlog 并并行交付多个 Story（每个在独立 tmux 会话中）。 Delivery Daemon 需要 git 仓库和 staging 分支，会轮询已细化的 Story、在 tmux 中启动并行的 Claude Code 或 Codex 会话（默认 3 个槽位，可配置）、通过 git push 跨设备协调、监控健康状态、重试失败、归档已完成工作。它运行在私有 tmux 服务器中，socket 与仓库摘要绑定，第二个检出无法加入或破坏生命周期。还提供按需监控仪表板。 守护进程启动有严格的安全契约：daemon-setup.sh 和 daemon-start.sh 是带 #!/bin/bash -p shebang 的可执行文件，用普通 bash 解释器前缀调用会被拒绝并报 entry_authority_invalid；唯一替代方案是使用绝对路径、已验证的 Bash 并加 --noprofile --norc -p 参数。daemon-setup.sh 也是唯一可以创建或更新专用 daemon home worktree 的命令。启动时会验证该 home，若缺失、过期、脏、外来或分支错误则拒绝，且不会修复，也没有回退到工作检出的机制。由于入口会重建封闭的配置允许列表，导出了 GIT_EDITOR、GIT_CONFIG_COUNT、PYTHONPATH 等变量的 shell 无法启动守护进程——官方称这是契约而非缺陷，建议从干净环境启动，例如：env -i PATH=/usr/bin:/bin HOME="$HOME" TERM="$TERM" .gaai/core/scripts/daemon-start.sh。
兼容性与依赖 Discovery 和治理可与任何 AI 编程工具配合；Delivery 工作流可移植到支持子代理的 AI 编程运行时，Claude Code 是参考实现（守护进程使用 claude -p，因为 Claude Code 是首个暴露子代理原语的编程代理）。Delivery Daemon 明确支持两种本地无头执行器：Claude Code CLI（默认）和 Codex CLI（通过 GAAI_DAEMON_EXECUTOR=codex）。未知或不可用的执行器会在治理工作开始前停止并给出可操作的错误。 “无需安装包”是字面意思，并非零依赖声明：不会拉取任何东西（PyYAML 已 vendored 在树内），但 Delivery Daemon 需要 git、python3、node 和 tmux 已在 PATH 中，且 vendored 运行时是二进制 zipapp 而非可读源码。tmux 是必需而非可选（3.2 是名义下限，实际能力探测才是准入权威），没有 Terminal.app 或 nohup 回退。
适用场景与限制 适用：已有产品清晰度的开发者、独立创始人、资深工程师、小团队，需要代理可靠交付而不跑偏。 限制：Discovery 是对话式且刻意轻量，帮助结构化已知内容，不替代深度产品研究或团队协作头脑风暴；琐碎任务仍需 backlog 条目（可以是一行，但门禁始终存在）；框架依赖代理遵循文件，没有程序化强制；仓库最近以 ELv2 发布，社区刚起步。 测试环境：macOS（Apple Silicon）。Linux 和 WSL（Windows）预期可用但尚未验证。 许可：source-available，采用 Elastic License 2.0（ELv2）。作者：Frédéric Geens。
