用途：按批次执行 Vignette 的 TODO 条目。一次运行接收一个基础分支和 docs/TODOS.md 中的一组条目，结束时给出一个由 Pete 手工测试的集成分支、docs/ 下的运行报告，并把条目标记为已落地。规划前须先阅读 Vignette 检出目录中的 AGENTS.md。
角色：编排者负责规划、简报、编排与评审，不写产品代码；被委派的智能体各自一个 worktree 写代码和验证；另有一个集成者、一个对抗性评审者，需要时可加一个架构巡检。
使用方式：先确定基础分支（默认 foundation）、运行标签（todoN）、条目原文，以及 Pete 是否在 Mac 前。把条目按涉及文件分组，展示分组表（智能体、分支、条目、文件）、组内顺序、共享文件和合并顺序，得到确认后再继续。用 scripts/setup-run.sh <run> <base> <name>... 创建各 worktree 并准备 scratch 目录，记录打印出的 settings mtime。把模板填入 ~/Code/vignette-todo/：BRIEF.md、items/<name>.md、INTEGRATOR.md、REVIEWER.md，需要巡检时还有 ARCHITECTURE.md，并替换其中占位符。一条消息内并发启动所有编码智能体，保存其报告到 reports/<name>.md，把遗留项追加到 INTEGRATOR.md 后再启动集成者；集成者合并、逐次构建与测试、人工读双分支触及的文件、跑冒烟轮次并提交 docs/run-<date>.md。随后对 <base>..<run>/integration 启动评审者，架构巡检可只读基础检出并行进行。评审确认的问题与巡检的安全清理以“Review fixes: …”路由回同一集成者。最后在集成 worktree 中自行运行 ./scripts/build.sh --test。
交接：未获要求不合并到基础分支；在基础分支上把条目标记为 landed（编排者唯一提交处），再运行 scripts/finish-run.sh <run>。报告分支与顶端、各条目落地情况、开放问题、只有人工能检查的内容、事故记录和 Mac 状态。
限制与风险：所有 worktree 构建相同 bundle id，URL 必须经 open -g -a <own app>，每次启动带 VIGNETTE_SETTINGS=<scratch>，动作前用 ps -wwEp 确认 pid，启动加 launch.lock 且一次一个，每轮后恢复 Pete 的构建。合成输入会到达最前台窗口，须先 [state]，绝不用 Escape 或 Cmd+Q。价格与平台等未在资料中提供。