dev-starter

Local Trunk 工作流

Paseo worktree、共享 Integration Queue、串行集成、check 与发布。

多个 Agent 在短生命周期 worktree 中并行开发；完成后进入共享 Integration Queue；一个 Integrator 决定顺序；集成锁保证一次只有一个任务推进 main。

不变量

  1. Agent 不直接改 main；只有 scripts/integration-runner 在持有 integration.lock 时推进主干。
  2. 一个任务 = 一个 Paseo workspace = 一个 git worktree = 一个 branch。
  3. 完成 = submit，不是 PR。
  4. Queue 位于 git common dir，所有 worktree 共享。
  5. 集成串行；冲突回到原任务 Agent。
  6. Integrator 只能在 ready 集合内排序，不能违反显式依赖。
  7. Done 不等于稳定版本；稳定版本只由 git tag vX.Y.Z 表达。

生命周期

Backlog
  ↓  Paseo New workspace / Carseod card
Developing        worktree + OMP session
  ↓  commit + ./scripts/check
  ↓  INTEGRATION_READY 或 ./scripts/integration-submit
Ready to Integrate
  ↓  integration-runner 预检 + Integrator 排序
Integrating       rebase → check → ff-only main
  ↓
Dev Shipped       main + dev build + publish
  ↓
Done              人的验收（不等于 release）

集成检查

scripts/check 是项目自己的最小 gate，必须 exit 0。集成 runner 还会在启用 docs-sync.json 时执行文档 gate：

./scripts/docs-sync check --base <main-before>

失败时主干不移动，check 失败上下文回到原任务 workspace。

常用命令

./scripts/task-start TASK-42 "标题"
./scripts/integration-submit
./scripts/integration-runner
./scripts/integration-status
./scripts/release 0.10.0

没有 Paseo 时可用 ./scripts/task-start ... --no-paseo；Integrator 不可用时用 ./scripts/integration-runner --fifo。

Paseo 入口

workflow 插件把 workflow 仓库里的 local workspace 请求转成 worktree，自动 attach task、注入 WORKFLOW_TASK_ID 与任务规范，并在最终回复检测到 INTEGRATION_READY 后自动 submit / integrate。

question/… 分支的讨论 worktree 不注册 task、不注入任务规范，也不自动 submit / integrate。

On this page

不变量生命周期集成检查常用命令Paseo 入口
Local Trunk 工作流 · dev-starter