baa-conductor

commit

28829de

parent

b321cee

author

im_wower

date

2026-03-21 21:43:24 +0800 CST

Document second-wave startup baseline

 1@@ -0,0 +1,29 @@
 2+# 第二波统一开工说明
 3+
 4+第二波任务统一要求如下：
 5+
 6+- 所有任务必须从 `main@b321cee` 切分支
 7+- 每个任务使用独立 worktree
 8+- 新 worktree 第一次进入后先执行 `npx --yes pnpm install`
 9+- 不允许从其他任务分支继续切分支
10+- 开始时把任务卡状态改为 `in_progress`
11+- 完成并推送后把任务卡状态改为 `review`
12+
13+推荐命令模板：
14+
15+```bash
16+git fetch origin
17+git switch main
18+git pull --ff-only origin main
19+git worktree add ../baa-conductor-TXXX -b feat/T-XXX-name main
20+cd ../baa-conductor-TXXX
21+npx --yes pnpm install
22+```
23+
24+每个实例启动后按顺序读：
25+
26+1. `DESIGN.md`
27+2. `coordination/TASK_OVERVIEW.md`
28+3. `coordination/WORKFLOW.md`
29+4. `coordination/tasks/T-XXX-*.md`
30+

 1@@ -52,6 +52,12 @@
 2 - `T-009` Firefox 插件 Pause/Resume 协议
 3 - `T-010` Status API 与基础 UI
 4 
 5+第二波统一基线：
 6+
 7+- 所有第二波任务都必须从 `main@b321cee` 切出
 8+- 每个新 worktree 第一次进入后先执行 `npx --yes pnpm install`
 9+- 不允许从其他任务分支继续切分支
10+
11 ## 5. 当前活动任务矩阵
12 
13 | Task | 标题 | 状态 | 分支 | 依赖 | 主要写入范围 |

 1@@ -18,7 +18,8 @@
 2    - `updated_at`
 3 2. 建自己的 branch
 4 3. 建自己的 worktree
 5-4. 只在 `write_scope` 内开发
 6+4. 在新 worktree 中先执行依赖安装
 7+5. 只在 `write_scope` 内开发
 8 
 9 ## 3. 每个实例开发时的规则
10 
11@@ -58,6 +59,8 @@
12 
13 ```bash
14 git worktree add ../baa-conductor-T004 -b feat/T-004-conductor-lease main
15+cd ../baa-conductor-T004
16+npx --yes pnpm install
17 ```
18 
19 对应关系：

 1@@ -4,7 +4,7 @@ title: Control API Worker
 2 status: todo
 3 branch: feat/T-003-control-api
 4 repo: /Users/george/code/baa-conductor
 5-base_ref: main
 6+base_ref: main@b321cee
 7 depends_on:
 8   - T-002
 9 write_scope:
10@@ -18,6 +18,12 @@ updated_at: 2026-03-21
11 
12 实现 Cloudflare Worker 风格的 control API 骨架，把设计中的关键接口落成代码结构。
13 
14+## 统一开工要求
15+
16+- 必须从 `main@b321cee` 切出该分支
17+- 新 worktree 进入后先执行 `npx --yes pnpm install`
18+- 不允许从其他任务分支切分支
19+
20 ## 本任务包含
21 
22 - 明确路由注册方式

 1@@ -4,7 +4,7 @@ title: Conductor Lease 与 Heartbeat
 2 status: todo
 3 branch: feat/T-004-conductor-lease
 4 repo: /Users/george/code/baa-conductor
 5-base_ref: main
 6+base_ref: main@b321cee
 7 depends_on:
 8   - T-002
 9   - T-003
10@@ -20,6 +20,12 @@ updated_at: 2026-03-21
11 
12 实现 conductor 的主备基础行为：注册、heartbeat、lease 获取与续租、standby 拒绝调度。
13 
14+## 统一开工要求
15+
16+- 必须从 `main@b321cee` 切出该分支
17+- 新 worktree 进入后先执行 `npx --yes pnpm install`
18+- 不允许从其他任务分支切分支
19+
20 ## 本任务包含
21 
22 - conductor startup checklist 落代码

 1@@ -4,7 +4,7 @@ title: Checkpoint 与 Git Diff Snapshots
 2 status: todo
 3 branch: feat/T-006-checkpointing
 4 repo: /Users/george/code/baa-conductor
 5-base_ref: main
 6+base_ref: main@b321cee
 7 depends_on:
 8   - T-005
 9 write_scope:
10@@ -19,6 +19,12 @@ updated_at: 2026-03-21
11 
12 把设计中的 checkpoint 概念落到代码结构里，尤其是 `summary`、`git_diff`、`log_tail` 这些中途恢复能力。
13 
14+## 统一开工要求
15+
16+- 必须从 `main@b321cee` 切出该分支
17+- 新 worktree 进入后先执行 `npx --yes pnpm install`
18+- 不允许从其他任务分支切分支
19+
20 ## 本任务包含
21 
22 - checkpoint 类型定义

 1@@ -4,7 +4,7 @@ title: Firefox 插件 Pause 与 Resume 协议
 2 status: todo
 3 branch: feat/T-009-firefox-pause
 4 repo: /Users/george/code/baa-conductor
 5-base_ref: main
 6+base_ref: main@b321cee
 7 depends_on:
 8   - T-001
 9 write_scope:
10@@ -18,6 +18,12 @@ updated_at: 2026-03-21
11 
12 先在本仓库中明确 Firefox 插件与 conductor control API 之间的协议，方便后续在插件仓库同步实现。
13 
14+## 统一开工要求
15+
16+- 必须从 `main@b321cee` 切出该分支
17+- 新 worktree 进入后先执行 `npx --yes pnpm install`
18+- 不允许从其他任务分支切分支
19+
20 ## 本任务包含
21 
22 - 定义浏览器按钮行为

 1@@ -4,7 +4,7 @@ title: Status API 与基础 UI
 2 status: todo
 3 branch: feat/T-010-status-api
 4 repo: /Users/george/code/baa-conductor
 5-base_ref: main
 6+base_ref: main@b321cee
 7 depends_on:
 8   - T-003
 9   - T-004
10@@ -19,6 +19,12 @@ updated_at: 2026-03-21
11 
12 实现最小状态读取层，让人和浏览器能读取 leader、mode、queue depth、active runs 等关键信息。
13 
14+## 统一开工要求
15+
16+- 必须从 `main@b321cee` 切出该分支
17+- 新 worktree 进入后先执行 `npx --yes pnpm install`
18+- 不允许从其他任务分支切分支
19+
20 ## 本任务包含
21 
22 - status snapshot 结构完善