mstar-iteration

mstar-iteration（迭代管理）

Load order

Read mstar-harness-core first. Path symbols → mstar-conventions. Per-plan gates → mstar-phase-gates. Knowledge crystallization → mstar-compound. Phase 2 implement 波次（进入 per-plan implement 前）→ mstar-sdd + mstar-dispatch-gates；Phase 2 QC 前 → mstar-review-qc。Git/worktree 载体（有 git 写或 lease 时）→ mstar-branch-worktree。Phase 1 角色派发 preflight（每次 invoke 前的 assignment preflight；enforcement: hard fail-fast）→ references/command-shared-invariants.md（本 skill 直接触发时不依赖 command 层）。On conflict, mstar-harness-core wins.

Phase detail 不在本 skill 正文：按下方 Phase route map 只加载当前动作对应的一行 detail——禁止无条件通读全部 phase references。

设计思路

mstar 实践模式通常是：一次迭代锁定几个 spec 点（specify + clarify），产生多个 plan，每个 plan 含多个 tasks。per-plan 生命周期有完整的闭环（Prepare → Execute → QC → Done）。Compound 不是 per-plan 活动——它是迭代级收口，在迭代内所有 plan Done 后，沉淀一轮知识。

本 skill 管理迭代 Phase 1–5（command 层可聚合编排，但 不得反向引用 command 名；第三方 helper 仅由 command 按需发现）：

Phase 1: start
     ↓
Phase 2: Autonomous Execute  —— [per-plan lifecycle × N]
     ↓
Phase 3: iteration-close
     ↓
Phase 4: PR delivery（开 PR）
     ↓
Phase 5: PR merge-ready loop —— 至 mergeable + CI 全绿 + reviews resolved
     ↓
迭代交付完成

关键定位：

• Phase 3 在 integration 分支收口 compound / roadmap；开 PR（Phase 4）≠ 迭代交付完成。
• Phase 5 是 merge-ready loop（修复 → 等 CI/review 波次结束再 push → 再验证，至 §5.5 exit）；Loop 理念与 push cadence SSOT 在本 skill（§2.6；push cadence 细则 §5.1a → references/phase-4-5-pr-delivery.md）；宿主 command 可叠加额外 non-mstar-* helper（优先 babysit / *-babysit；greploop 可选），但不写入 mstar-* load order。
• 一次迭代 = 一个 PR；compound 产物随 PR 合入 snapshot branch.target。

Phase route map（唯一路由表 — 按当前动作加载）

当前动作	必读 detail（按需加载，勿通读）
start（启动迭代 / 重开方向锁定）	references/phase-1-prepare.md（§1.1–§1.6：上下文、范围与 direction lock、compass、索引、v2 状态面、产物边界、§1.6 Review & Edit 链）
execute / resume（推进或恢复 per-plan 循环）	references/phase-2-worktree-lease.md（§2.0 五道闸、§2.1–§2.5 loop/dispatch 细则、control worktree + lease 全文）
close（全部 plan Done 后收口迭代）	references/phase-3-iteration-close.md（§3.0–§3.6：entry checklist、compound、roadmap、完成标记、exit checklist + commit）
PR / merge-ready（开 PR、推进合并就绪 loop）	references/phase-4-5-pr-delivery.md（§4–§5.2：开 PR、§5.1a push cadence、loop、exit checklist）
Phase 5 helper discovery（仅 command 层按需）	references/phase5-helper-discovery.md（babysit / greploop 发现）