baa-conductor

README.md

 1# baa-conductor
 2
 3`baa-conductor` 是新的 AI 执行编排仓库。
 4
 5它的目标不是提供单个 AI 会话，而是提供一套以 `mini` 为唯一中控、带自启动和浏览器控制面的稳定执行基础设施。
 6
 7当前仓库状态：
 8
 9- 设计文档已落在 [`DESIGN.md`](./DESIGN.md)
10- 代码目录骨架已建立
11- 当前推荐部署模式已经收口为 `mini` 单节点
12- 并行任务文档已放在 [`coordination/`](./coordination/)
13
14## 先读什么
15
16每个 Codex 实例启动后，按这个顺序读：
17
181. [`DESIGN.md`](./DESIGN.md)
192. [`coordination/TASK_OVERVIEW.md`](./coordination/TASK_OVERVIEW.md)
203. 自己的任务卡，例如 `coordination/tasks/T-004-conductor-lease.md`
21
22## 当前目录结构
23
24```text
25apps/
26  control-api-worker/
27  conductor-daemon/
28  status-api/
29  worker-runner/
30plugins/
31  baa-firefox/
32packages/
33  auth/
34  checkpointing/
35  db/
36  git-tools/
37  logging/
38  planner/
39  schemas/
40  step-templates/
41ops/
42  launchd/
43  nginx/
44  sql/
45coordination/
46  STATUS_SUMMARY.md
47  TASK_OVERVIEW.md
48  WORKFLOW.md
49  tasks/
50docs/
51  auth/
52  decisions/
53  firefox/
54  ops/
55  runtime/
56```
57
58## 当前约定
59
60- 当前只保留 `mini` 的 conductor / status-api / 自启动路径
61- 不再继续推进 `mac` 备主与主备切换
62- 一个任务一个分支
63- 一个任务一个 worktree
64- 一个任务一个任务卡
65- 任务真相靠任务卡与 D1，不靠聊天记录
66- 各 Codex 只更新自己的任务卡
67- 汇总状态由整合者更新到 `coordination/STATUS_SUMMARY.md`
68
69## 现在可以做什么
70
71当前最适合的工作方式：
72
731. 由整合者分配 `coordination/tasks/` 里的任务
742. 每个 Codex 建自己的分支与 worktree
753. 在声明好的 `write_scope` 内开发
764. 完成后更新任务卡中的状态、命令、风险和交付物
775. 由整合者统一汇总和集成
78
79## 非目标
80
81当前骨架阶段不追求：
82
83- 已完成的生产功能
84- 完整测试覆盖
85- 完整 control API
86- 完整的 D1 接入
87
88这些都将在后续并行任务中完成。