@mstar-harness/opencode 0.7.0 → 0.7.3

package/harness-commands/iteration-drive.md

@@ -13,9 +13,10 @@ Drive the active Morning Star iteration forward. The canonical flow is in **`mst
 1. `mstar-harness-core`
 2. `mstar-roles` → `references/project-manager.md`
 3. `skills/pm/SKILL.md` → **§ Host entry** + **§ Boot**（PM role identity + dispatch-first rules）
-4. `mstar-iteration` → **§ Phase 2: Autonomous Execute**（per-plan dispatch loop）+ **§ Phase 3: iteration-close**（compound + compass）
-5. `mstar-dispatch-gates` + host reference
-6. `mstar-plan-artifacts`, `mstar-plan-conventions`, `mstar-branch-worktree`
+4. `mstar-iteration` → **§ Phase 2** + **§ Phase 3**（close 为独立 gate，§3.0–§3.5）
+5. `mstar-compound` — Phase 3 §3.2 前加载（含 Phase 6 索引登记）
+6. `mstar-dispatch-gates` + host reference
+7. `mstar-plan-artifacts`, `mstar-plan-conventions`, `mstar-branch-worktree`
 
 ## Phase 2: Autonomous Execute
 
@@ -39,12 +40,16 @@ Execute **`mstar-iteration` § Phase 2** exactly. Summary:
 
 ## Phase 3: iteration-close
 
-When every plan is `Done`, execute **`mstar-iteration` § Phase 3**:
+当 **every** plan 为 `Done` 时，**STOP** per-plan loop，打印 `## Phase 3: iteration-close`，按 **`mstar-iteration` § Phase 3** 逐步执行。final plan 的 closure 只能提供输入，不能替代 close gate。
 
-1. **前置检查** (§ 3.1) — all plans Done, residuals closed, compass synced
-2. **Compound 轮** (§ 3.2) — 收集素材 → 自检清单（Q1-Q8）→ `mstar-compound` → CONCEPTS.md
-3. **更新 compass** (§ 3.3-3.4) — status → completed, roadmap, compound summary, retrospective, index
-4. **Commit** to integration branch:
+| Step | Section | 要点 |
+|------|---------|------|
+| 1 | §3.0 / §3.0.5 | Phase 边界；legacy compass 规范化（frontmatter + `## Roadmap Position`） |
+| 2 | §3.1 | 打印 close entry checklist，全部 `[x]` |
+| 3 | §3.2 | Compound；新增 doc 完成 `mstar-compound` Phase 6（`{KNOWLEDGE_DIR}/README.md`） |
+| 4 | §3.3 | `## Roadmap Position` current iteration → `delivered`；STRATEGY/tracker 按需更新 |
+| 5 | §3.4 | frontmatter `status: completed` + `end_date`；Compound Summary + Retrospective |
+| 6 | §3.5 | 打印 close exit checklist → commit → push |
 
 ```bash
 git add {ITERATION_DIR}/ {KNOWLEDGE_DIR}/ CONCEPTS.md
@@ -52,6 +57,8 @@ git commit -m "chore(iteration): close <iteration-id> — compound round, roadma
 git push origin <spec_integration_branch>
 ```
 
+**Not Done until**: §3.5 checklist `[x]` + compass frontmatter `completed`.
+
 ## Completion: Create PR
 
 All iteration-close changes committed to integration branch:

package/harness-commands/iteration-start.md

@@ -1,21 +1,24 @@
 ---
 name: iteration-start
-description: Start a new harness iteration — research backlog, lock direction with grill-me, produce compass/plans, run edit chain (product-manager → architect → writing-specialist each review-and-edit, then PM final review and lock), submit to integration branch
+description: Start a new harness iteration — research backlog, lock direction with grill-me, produce compass/plans, run mandatory Review & Edit chain via Task dispatch (product-manager → architect → writing-specialist each review-and-edit, then PM final lock), then integration branch. Not Done until review chain completes and compass is locked.
 agent: project-manager
 ---
 
 # Start Iteration
 
-Start a new Morning Star harness iteration. Detailed workflow → **`mstar-iteration` § Phase 1: iteration-start**；per-plan Prepare gates → **`mstar-phase-gates`**（specify → clarify → plan）。
+Start a new Morning Star harness iteration. **Not Done until the Review & Edit chain runs via dispatched roles and PM lock — not when compass files are first written.**
+
+Detailed workflow → **`mstar-iteration` § Phase 1: iteration-start**（含 §1.6 Review & Edit chain）；per-plan Prepare gates → **`mstar-phase-gates`**（specify → clarify → plan）。
 
 ## 0. Boot
 
 1. `mstar-harness-core`
 2. `mstar-roles` → `references/project-manager.md`
 3. `skills/pm/SKILL.md` → **§ Host entry** + **§ Boot**
-4. `mstar-iteration` → **§ Phase 1: iteration-start**（迭代范围、compass 模板、状态初始化）
-5. `mstar-phase-gates` → Prepare（specify → clarify → plan）
-6. `mstar-plan-conventions`, `mstar-plan-artifacts`
+4. `mstar-iteration` → **§ Phase 1: iteration-start**（迭代范围、compass 模板、§1.6 Review & Edit chain、状态初始化）
+5. `mstar-dispatch-gates` → iteration-start review chain + implement dispatch
+6. `mstar-phase-gates` → Prepare（specify → clarify → plan）
+7. `mstar-plan-conventions`, `mstar-plan-artifacts`
 
 ## 1. Research
 
@@ -63,17 +66,49 @@ Produce harness artifacts per **`mstar-iteration` § 1.3 创建迭代 compass**
 - Register all plans in `{HARNESS_DIR}/status.json`（per `mstar-plan-artifacts`）
 - Update `{ITERATION_DIR}/README.md` index（per `mstar-iteration` § 1.4）
 
-## 5. Review & Edit Chain
+## 5. Review & Edit Chain（HARD GATE — do not commit before this）
+
+**STOP**: Do not run §6 Integration Branch until **all** rows below are true.
 
 Each role below **reviews and directly edits** the documents. Do not just flag issues — apply the fixes yourself. PM only steps in for the final lock.
 
-1. **@product-manager** — review and edit the compass; adjust scope, priorities, and user-facing details; write or update specs in `{SPECS_DIR}/`
-2. **@architect** — review and edit the compass and specs; adjust technical architecture, interface contracts, module boundaries, and trade-off reasoning
-3. **@writing-specialist** — review and edit all documents for clarity, consistency, completeness, and bilingual parity; tighten prose, unify terminology, and remove ambiguity
-4. **PM** — final review; lock all documents; confirm Prepare phase gates pass
+| # | Role | Required action |
+|---|------|-----------------|
+| 5.1 | **@product-manager** | Task subagent: **edit** compass, plans, `{SPECS_DIR}/`; scope, UX, priorities |
+| 5.2 | **@architect** | Task subagent: **edit** compass, plans, specs; contracts, SQL, module boundaries |
+| 5.3 | **@writing-specialist** | Task subagent: **edit** all iteration docs; terminology, structure, clarity |
+| 5.4 | **@project-manager** | Merge subagent edits; resolve conflicts; **lock** compass (`status: locked`); confirm Prepare gates |
+
+**Evidence of done** = edited compass / plans / specs on disk + compass `status: locked`. **No** separate iteration review reports under `reports/` — unlike per-plan QC, there is no downstream audit chain to preserve.
+
+**Tool rule (Cursor / hosts with Task)**:
+- Steps 5.1–5.3: **MUST** use `Task` (parallel when independent). See **`mstar-dispatch-gates`** · iteration-start review chain.
+- PM thread **MUST NOT** substitute by performing all three specialist edits itself.
+- Exception: user explicitly waives subagent dispatch ("PM-only review").
+
+**Prepare gate (per plan in compass)**:
+- [ ] specify / clarify / plan = done on each plan file
+- [ ] `primary_spec` path exists (if declared)
+- [ ] `blocked_by` / sequential deps documented
+
+Only after 5.4 → proceed to §6.
+
+### iteration-start pre-commit checklist
+
+PM must print this block before §6; all `[ ]` must be `[x]`:
+
+- [ ] grill-me decisions recorded in compass
+- [ ] Draft compass + plans + `status.json` registered
+- [ ] @product-manager Task completed — compass / plans / specs edited
+- [ ] @architect Task completed — compass / specs edited
+- [ ] @writing-specialist Task completed — iteration docs edited
+- [ ] PM final lock: compass `status: locked`; Prepare gates pass (blocked plans documented)
+- [ ] **THEN**: git commit + push `iteration/<iteration-id>`
 
 ## 6. Integration Branch
 
+**Precondition**: §5 complete — compass `status: locked`; specialist Tasks returned; Prepare gates confirmed.
+
 - Create `iteration/<iteration-id>` from `main`
 - Register `spec_integration_branch` in `{HARNESS_DIR}/status.json`
 - Commit all documents to the integration branch and push to remote

package/harness-skills/mstar-compound/SKILL.md

@@ -211,6 +211,8 @@ If `CONCEPTS.md` doesn't exist yet, ask whether to seed it. A seed populates the
 
 2. If `plan_id` was provided, optionally update `status.json` metadata to reference this doc under `knowledge_refs`.
 
+**iteration-close gate**: `mstar-iteration` §3.2 #5 — **each** new doc in the compound round must complete this phase; do not skip for lightweight captures.
+
 ## Phase 7: Refresh trigger
 
 After capturing, check if the new learning suggests an older doc may now be stale (contradicted, superseded, or in a refactored domain). If so, recommend:

package/harness-skills/mstar-dispatch-gates/SKILL.md

@@ -70,11 +70,20 @@ description: Morning Star 派发与委派门禁 —— 仅 PM 可增派 subagent
 - **QC 三审**在 feature 开发完成后执行；三名 reviewer 共用同一组 `Review cwd` / `Working branch` / `plan_id` / `Review range` / `Diff basis`（**`mstar-branch-worktree`**）。
 - **同一 plan 多 batch**：默认整 plan 交付完成跑一轮完整三审；**fix 后默认 targeted re-review**（N = 被指派的 QC 席位数，同条消息发满 N）；**仅** Assignment 写明 **`QC re-review: full tri-review`** 时复跑三审且用新文件名（**`mstar-plan-artifacts/references/plan-files-and-reports.md`**、**`mstar-review-qc`**）。
 
+## iteration-start Review & Edit chain
+
+与 QC 三审同理：**dispatch-first** 适用于文档审查角色，不限于 implement/QC。
+
+- PM 写 compass/plans **初稿**；**@product-manager**、**@architect**、**@writing-specialist** 各通过 Task **直接编辑** compass / plans / specs（**不**另写 `reports/` 审查报告）。
+- PM 线程跳过派发、自行完成三角色全部编辑 = **反模式**（见 **`mstar-harness-core`** 反模式索引、`mstar-iteration` §1.6）。
+- Steps 5.1–5.3 须 **Task**（可并行）；PM lock（5.4）在 PM 线程完成。**不得**在 review chain 完成前 commit integration 分支。
+
 ## 反模式（派发）
 
 - QC 三审拆在多条消息或等 #1 返回再发 #2/#3。
 - 仅 1 次 invoke 却声称「并行三审已启动」。
 - 递归同角色 subagent；把 Handoff / 多轨编排措辞当 invoke。
+- iteration-start 在 Review & Edit chain 完成前 commit；PM 代做三角色全部编辑而不派发 Task。
 
 ## References
 

package/harness-skills/mstar-harness-core/SKILL.md

@@ -139,6 +139,9 @@ Read **`mstar-host`** after this skill; detect host per its table, then Read the
 | 无证据宣称完成 | `mstar-coding-behavior` / verification |
 | CreatePlan 不落盘 / 无 `{HARNESS_DIR}` mirror | `mstar-host` · `cursor-plan-mode-bridge` |
 | 临时方案 / 后续计划只写在对话里 | `mstar-phase-gates` · Durable Roadmap Gate |
+| iteration-start commit before review chain | `mstar-iteration` §1.6；PM 模拟三角色编辑而不派发 Task |
+| Phase 3 折叠进 final plan closure / 跳过 §3.1 gate | `mstar-iteration` §3.0–§3.5；`iteration-drive` Phase 3 |
+| iteration-close 无 frontmatter completed / 漏 compound Phase 6 | `mstar-iteration` §3.0.5、§3.4、§3.2 #5 |
 
 ## 可选：OpenViking Memory
 

package/harness-skills/mstar-iteration/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mstar-iteration
-description: Morning Star 迭代管理 —— iteration-start（锁定迭代范围与 roadmap）、Autonomous Execute（per-plan 派发循环：分支→实现→QC→QA→Done→合并，含跨 plan 进度追踪与 push 纪律）、iteration-close（收口知识结晶 `mstar-compound`、更新 roadmap、标记迭代完成）。触发：PM 启动新迭代、跨 plan 编排时、或迭代内所有 plan Done 后。迭代 compass 落盘 `{ITERATION_DIR}/<iteration-id>-delivery-compass.md`；per-plan 状态 SSOT 仍为 `{HARNESS_DIR}/status.json`。适用于一次迭代锁定几个 spec 点（specify+clarify）、多个 plan、每个 plan 多个 tasks 的实践模式。
+description: Morning Star 迭代管理 —— iteration-start（锁定范围、Review & Edit chain 硬门禁）、Autonomous Execute（per-plan 派发循环）、iteration-close（独立 Phase：close gate、compound、roadmap、compass completed）。触发：PM 启动新迭代、跨 plan 编排、或全部 plan Done 后收口。compass：`{ITERATION_DIR}/<iteration-id>-delivery-compass.md`；per-plan SSOT：`{HARNESS_DIR}/status.json`。
 ---
 
 # mstar-iteration（迭代管理）
@@ -19,7 +19,7 @@ mstar 实践模式通常是：一次迭代锁定几个 spec 点（`specify + cla
 iteration-start → [per-plan lifecycle × N] → iteration-close → PR → merge
      │                                               │
      │ 锁定范围、创建 compass                        │ compound、更新 roadmap
-     │ 登记 plans 到 compass                         │ 标记迭代完成
+     │ Review & Edit chain → PM lock                 │ 标记迭代完成
      │ 创建 integration 分支                          │ commit 到 integration 分支
      │                                               │
      └──────── iteration-drive（跨 plan 追踪）────────┘
@@ -58,11 +58,11 @@ PM 在新迭代启动时执行。
 | **里程碑** | 关键节点与日期 |
 | **验收标准** | 迭代级别的 Done 定义 |
 | **非目标** | 明确排除在本次迭代外的事项 |
-| **Roadmap 上下文** | 本迭代在整体 roadmap 中的位置（本批做什么 / 下批做什么） |
+| **Roadmap 上下文** | 本迭代在整体 roadmap 中的位置（current iteration / next iteration） |
 
 ### 1.3 创建迭代 compass
 
-写入 `{ITERATION_DIR}/<iteration-id>-delivery-compass.md`：
+写入 `{ITERATION_DIR}/<iteration-id>-delivery-compass.md`。**必须**使用 `references/iteration-compass-template.md` 完整结构（YAML frontmatter + `## Roadmap Position` + close 占位节）。`end_date` 仅在 iteration-close 填入；禁止用正文 completion prose 替代 frontmatter `status`。
 
 ```markdown
 ---
@@ -95,8 +95,8 @@ plans: []
 - <明确排除的事项>
 
 ## Roadmap Position
-- 本批：<what this iteration delivers>
-- 下批：<what comes next, owner, trigger>
+- Current iteration: <what this iteration delivers>
+- Next iteration: <what comes next, owner, trigger>
 ```
 
 ### 1.4 更新索引
@@ -111,6 +111,21 @@ plans: []
 
 若使用 `status.json`，在 `plans[].metadata` 中为受影响的 plan 设置 `iteration_refs`。
 
+### 1.6 Review & Edit chain（integration 分支前强制）
+
+**iteration-start 在 PM lock 前不算完成**——compass/plans 初稿落盘 ≠ Done。
+
+与 host 命令 `iteration-start` §5 对齐：产物 SSOT 在本节；派发机制 SSOT 在命令 + **`mstar-dispatch-gates`**。
+
+PM **不得**将迭代 harness 文档 commit 到 `spec_integration_branch`，直到：
+
+1. **@product-manager**、**@architect**、**@writing-specialist** 已通过宿主 Task（或等价角色 invoke）**直接编辑**（非仅评论）compass、plans 及受影响 specs
+2. PM 将 compass `status` 设为 `locked`，并确认各 plan 的 Prepare gate（specify / clarify / plan）
+
+**完成证据** = 磁盘上的 compass / plans / specs 修订 + compass `status: locked`。**不**要求 `reports/<iteration-id>/` 审查报告——迭代审查的 SSOT 是被编辑的文档本身，无 per-plan QC 式审计链。
+
+**反模式**：PM 线程代替三角色完成全部编辑而不派发 Task —— 见 **`mstar-harness-core`** 反模式索引。
+
 ---
 
 ## Phase 2: Autonomous Execute（per-plan 派发驱动）
@@ -164,7 +179,7 @@ SSOT = `{HARNESS_DIR}/status.json` + `{PLAN_DIR}/`。todos 只追踪本轮下一
 5. **Cross-plan 进度同步**：更新 `{ITERATION_DIR}/<iteration-id>-delivery-compass.md` 的 `## Plans` 表状态列
 6. **Next plan** 从步骤 1 继续
 
-全部 plan `Done` → 停止循环，进入 **Phase 3: iteration-close**。
+全部 plan `Done` → **STOP** per-plan loop（§2.4 结束），打印 **`## Phase 3: iteration-close`**，按 §3.0 起独立执行。final plan 的 Assignment / closure 可以提供素材，但不能替代 Phase 3 gate。
 
 ### 2.5 Dispatch-first（implement 派发约束）
 
@@ -188,16 +203,40 @@ SSOT = `{HARNESS_DIR}/status.json` + `{PLAN_DIR}/`。todos 只追踪本轮下一
 
 ## Phase 3: iteration-close（收口迭代）
 
-PM 在迭代内全部 plan Done 后执行。**本 Phase 在 integration 分支上运行**，产出物 commit 到 integration 分支，随迭代 PR 合入 main。触发方：`commands/iteration-drive.md`（在 Autonomous Execute loop 全部 Done 后自动进入）。
+PM 在迭代内全部 plan Done 后执行。**本 Phase 在 integration 分支上运行**，产出物 commit 到 integration 分支，随迭代 PR 合入 main。触发方：`commands/iteration-drive.md`（Autonomous Execute 全部 Done 后进入）。
+
+**Close Done 定义**：§3.1→§3.5 全部完成；compass frontmatter 写入 `status: completed` + `end_date`；每篇新增 knowledge doc 已登记 `{KNOWLEDGE_DIR}/README.md`。只在 final plan 中写了 compound / roadmap / PR 说明，不算 iteration-close 完成。
+
+### 3.0 Phase boundary（HARD）
+
+- Phase 3 是 iteration 级收口，不是任一 plan 的子任务。
+- final plan closure、plan notes、plan compaction 可作为输入，但不能替代 §3.1→§3.5。
+- 读过 `mstar-iteration` / `mstar-compound` 不等于执行 gate；必须打印 checklist 并写入产物。
+
+### 3.0.5 Compass shape normalization（legacy 漂移修复）
 
-### 3.1 前置检查
+进入 §3.1 前，先确认 compass 具有 close 可写入的结构。若缺失，PM 在本 thread 做最小规范化，不委派、不重写无关内容。
 
-确认以下条件全部满足后，方可进入 iteration-close：
+| 检查 | 缺则补齐 |
+|------|----------|
+| YAML frontmatter：`iteration_id`, `start_date`, `status` | 从文件名 / 正文提取；收口前 `status` 保持 `active` 或 `locked` |
+| `## Roadmap Position` | 从 general context / roadmap prose 迁移为本节 |
+| `## Compound Round Summary` | 按模板补占位，§3.4 填写 |
+| `## Iteration Retrospective (minimal)` | 按模板补占位，§3.4 填写 |
 
-- [ ] 所有 compass 中登记的 plan 状态均为 `Done`
-- [ ] 所有 plan 的 residual findings 已收口（closed 或 accepted）
-- [ ] `{ITERATION_DIR}/<iteration-id>-delivery-compass.md` 各 plan 状态已同步到最新
-- [ ] 迭代验收标准已达成或显式豁免
+正文 completion status 只能作为历史注释；最终状态必须写入 frontmatter `status: completed` + `end_date`。
+
+### 3.1 Close entry checklist（HARD GATE）
+
+**STOP**: 打印下方 checklist，且全部为 `[x]` 后，才可进入 §3.2 Compound。
+
+- [ ] 所有 compass 中登记的 plan 在 `{HARNESS_DIR}/status.json` 均为 `Done`
+- [ ] 所有 plan 的 residual findings 已收口（closed 或 accepted；见 `mstar-plan-artifacts`）
+- [ ] compass `## Plans` 表状态列已与 `status.json` 同步
+- [ ] 迭代 `## Acceptance Criteria` 已达成或显式豁免（compass 或对话记录原因）
+- [ ] compass shape 已满足（frontmatter + `## Roadmap Position` + close 占位节）
+
+PM **必须**在对话中打印本 checklist；不得默认同过。
 
 ### 3.2 知识结晶（Compound）—— 迭代级核心收口
 
@@ -212,27 +251,44 @@ PM 触发 `mstar-compound`（可批量）：
    - 跨 plan 重复出现的模式
    - 有价值的排错经验
 
-2. **逐条结晶**：对每条识别出的知识，调用 `mstar-compound` 写入 `{KNOWLEDGE_DIR}/<category>/<slug>.md`
+2. **逐条判定**：对每条候选知识，回答 `mstar-compound` 的 Q1-Q8 自检；跳过项要在 compass `## Compound Round Summary` 记录原因。
+
+3. **写入或更新**：值得结晶的条目按 `mstar-compound` Phase 1-7 写入 `{KNOWLEDGE_DIR}/<category>/<slug>.md`，或在高重叠时更新已有文档。
 
-3. **是否值得结晶**：PM 使用 `mstar-compound` 中的「是否值得结晶」自检清单逐条评估（见 `mstar-compound` § 是否值得结晶）。
+4. **CONCEPTS.md 协同**：若迭代中引入了新的领域词汇，更新 `<repo-root>/CONCEPTS.md`（`mstar-compound` Phase 5）
 
-4. **CONCEPTS.md 协同**：若迭代中引入了新的领域词汇，更新 `<repo-root>/CONCEPTS.md`
+5. **索引登记（强制）**：每新增一篇 knowledge doc，必须完成 `mstar-compound` Phase 6，在 `{KNOWLEDGE_DIR}/README.md` 登记一行。Lightweight compound 不豁免 Phase 6。
+
+若本轮没有值得结晶的知识，仍须在 `## Compound Round Summary` 写明 `无可结晶知识` 及原因。
 
 ### 3.3 更新 roadmap
 
-1. 更新 compass 中的 `## Roadmap Position`：
-   - 本批状态标记为 `delivered`
-   - 下批更新为即将开始的内容
+1. 更新 compass **`## Roadmap Position`**（§3.0.5 已确保本节存在）：
+   - current iteration 行标记为 **`delivered`**（或等价明确措辞）
+   - next iteration 更新为即将开始的内容、触发条件、owner
 2. 若 `status.json` 中有 `plans[].metadata.roadmap` 字段，同步更新
-3. 若 `STRATEGY.md` 存在，可建议更新 `## Decision Log`（若有重大架构决策）
+3. 若存在 deferred-features / roadmap tracker 类文档，按项目惯例刷新
+4. 若 `STRATEGY.md` 存在，可更新 `## Decision Log`（重大架构决策时）
+
+### 3.4 标记迭代完成
+
+1. compass **YAML frontmatter**：`status: completed`，`end_date: YYYY-MM-DD`（必须；见 §3.0.5）
+2. 更新 `{ITERATION_DIR}/README.md` 索引中该迭代行 Status 为 `completed`
+3. 填充 compass `## Compound Round Summary` 与 `## Iteration Retrospective (minimal)`（见模板）
+
+### 3.5 Close exit checklist + commit
+
+**Precondition**: §3.1 checklist `[x]`；§3.4 frontmatter `completed` + `end_date` 已写。
 
-### 3.4 标记迭代完成 + Commit
+PM 打印 **iteration-close exit checklist**；全部为 `[x]` 后方可 `git commit` / 开 PR：
 
-1. 将 compass frontmatter `status` 更新为 `completed`，添加 `end_date`
-2. 更新 `{ITERATION_DIR}/README.md` 索引中该迭代行的 Status 为 `completed`
-3. compass 正文末尾追加 Compound Round Summary 和 Retrospective（见 compass 模板）
+- [ ] §3.1 前置 gate 已打印并满足
+- [ ] §3.2 compound 完成；新增 knowledge doc 均已登记 `{KNOWLEDGE_DIR}/README.md`（或已记录无可结晶原因）
+- [ ] §3.3 `## Roadmap Position` current iteration 已标 `delivered`；tracker / STRATEGY 已按需更新
+- [ ] §3.4 frontmatter `status: completed` + `end_date`；Compound Summary + Retrospective 已填
+- [ ] 当前分支是 `spec_integration_branch`
 
-**Commit 到 integration 分支**：iteration-close 产出的所有 harness 制品必须 commit 到当前 integration 分支，随迭代 PR 合入 main：
+**Commit 到 integration 分支**：
 
 ```bash
 git add {ITERATION_DIR}/<id>-delivery-compass.md {ITERATION_DIR}/README.md {KNOWLEDGE_DIR}/ CONCEPTS.md
@@ -240,7 +296,7 @@ git commit -m "chore(iteration): close <iteration-id> — compound round, roadma
 git push origin <spec_integration_branch>
 ```
 
-### 3.5 可选：触发 compound-refresh
+### 3.6 可选：触发 compound-refresh
 
 若本轮 compound 新增了较多知识文档，或 compass 标记了可能过时的旧知识，触发 `mstar-compound-refresh` 对有重叠的知识文档做维护。
 
@@ -270,4 +326,7 @@ git push origin <spec_integration_branch>
 - 不要在 iteration-drive 中修改 per-plan gate 判定
 - 不要用 compass 替代 `status.json` 作为 plan 状态 SSOT
 - 不要在没有完成 per-plan 前置检查的情况下进入 iteration-close
-- 不要跳过 compound——如果本迭代确实没有可结晶的知识，在 compass 中写 `Compound Round Summary: 无可结晶知识（原因：<简述>）`
+- 不要将 Phase 3 折叠进 final plan closure——须显式 §3.0→§3.5
+- 不要用 prose completion status 替代 compass frontmatter `status: completed` + `end_date`
+- 不要跳过 compound Phase 6（`{KNOWLEDGE_DIR}/README.md` 索引）——即使只结晶一篇文档
+- 不要跳过 compound——如果本迭代确实没有可结晶的知识，在 compass `## Compound Round Summary` 写 `无可结晶知识（原因：<简述>）`

package/harness-skills/mstar-iteration/references/iteration-compass-template.md

@@ -6,7 +6,6 @@ Copy this template when creating a new iteration compass in `{ITERATION_DIR}/`.
 ---
 iteration_id: <id>
 start_date: YYYY-MM-DD
-end_date: <filled at close>
 status: active
 plans: []
 ---
@@ -50,8 +49,8 @@ Status values: `Todo` | `InProgress` | `InReview` | `Done` | `Blocked`
 
 ## Roadmap Position
 
-- **本批（<iteration-id>）**：<what this iteration delivers>
-- **下批**：<what comes next>，触发条件：<condition>，owner：<who>
+- **Current iteration（<iteration-id>）**：<what this iteration delivers>
+- **Next iteration**：<what comes next>，触发条件：<condition>，owner：<who>
 - **最终目标**：<the long-term Done definition this iteration contributes to>
 
 ## Risk Register
@@ -83,14 +82,21 @@ Status values: `Todo` | `InProgress` | `InReview` | `Done` | `Blocked`
 |-------|----------|-------------|
 | `iteration_id` | Yes | iteration-start |
 | `start_date` | Yes | iteration-start |
-| `end_date` | No (fill at close) | iteration-close |
-| `status` | Yes | iteration-start → `active`; iteration-close → `completed` |
+| `end_date` | No | Add at iteration-close §3.4 only |
+| `status` | Yes | iteration-start → `active` / `locked`（§1.6 PM lock）；iteration-close §3.4 → **`completed`**（YAML frontmatter，非 prose completion status） |
 | `plans` (frontmatter) | Recommended | iteration-start (initial), iteration-drive (add new) |
 | `## Plans` table | Yes | iteration-drive (sync status), iteration-close (final) |
 | `## Milestones` | Recommended | iteration-start, iteration-drive (update) |
 | `## Acceptance Criteria` | Yes | iteration-start |
 | `## Non-Goals` | Yes | iteration-start |
-| `## Roadmap Position` | Yes | iteration-start, iteration-close (update) |
+| `## Roadmap Position` | **Yes** | iteration-start（必填节，非散落于 general context prose）；iteration-close §3.3（current iteration → `delivered`） |
 | `## Risk Register` | Optional | iteration-start, iteration-drive (update) |
-| `## Compound Round Summary` | Yes | iteration-close |
-| `## Iteration Retrospective` | Recommended | iteration-close |
+| `## Compound Round Summary` | Yes | iteration-close §3.4 |
+| `## Iteration Retrospective` | Recommended | iteration-close §3.4 |
+
+## Legacy compass drift
+
+若仓库中已有 compass **无** YAML frontmatter、**无** `## Roadmap Position`，或只有 prose completion status：
+
+- **新迭代**：iteration-start 必须按本模板重写，不延续 prose-only 惯例。
+- **收口时**：`mstar-iteration` §3.0.5 在 iteration-close 入口规范化，再执行 §3.3–§3.4。

package/harness-skills/pm/SKILL.md

@@ -40,6 +40,26 @@ Prepare/Execute gates, routing, Assignment templates, Task Board, QC tri-review,
 
 **Exceptions:** user explicitly asks PM thread to implement; hotfix per `mstar-phase-gates`.
 
+## iteration-start dispatch
+
+After grill-me + draft compass/plans（**`mstar-iteration` § Phase 1**）:
+
+- **Do not** commit to `iteration/<iteration-id>` until Review & Edit chain completes（§1.6）。
+- Dispatch **@product-manager**, **@architect**, **@writing-specialist** via host Task — **one invoke per role minimum**（parallel when independent）。
+- PM final lock is PM-whitelist work（compass `status: locked`, merge conflicts, Prepare gate confirmation）。
+- **Not** PM-whitelist: performing all three specialist document edits without subagent Task.
+
+Before §6 Integration Branch, print **`iteration-start` pre-commit checklist**（command §5）; all items must be `[x]`。
+
+## iteration-close（drive / 全部 plan Done 后）
+
+**`mstar-iteration` § Phase 3** 为独立 Phase；final plan closure 只能作为输入。
+
+- 全部 plan `Done` 后 **STOP** loop，打印 Phase 3 入场，从 §3.0 执行至 §3.5。
+- §3.1 close entry checklist 与 §3.5 close exit checklist 必须在对话中打印；全部为 `[x]` 方可 commit / PR。
+- 每篇新增 compound doc 必须完成 `mstar-compound` Phase 6（`{KNOWLEDGE_DIR}/README.md`）。
+- compass 完成形式：frontmatter `status: completed` + `end_date` + `## Roadmap Position` current iteration `delivered`——prose completion status 不算。
+
 ## Cursor Plan mode
 
 CreatePlan / SwitchMode: Read **`mstar-host/references/cursor-plan-mode-bridge.md`**. Bootstrap todos `harness-init` → `spec-register` → `mirror-plan` before implement todos; evidence on **subagent** work.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mstar-harness/opencode",
-  "version": "0.7.0",
+  "version": "0.7.3",
   "description": "Morning Star harness OpenCode plugin (skills bootstrap and agent loading).",
   "license": "MIT",
   "repository": {