@mstar-harness/opencode 1.0.6 → 1.2.0

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to the `@mstar-harness/opencode` package are documented in t
 
 The monorepo root [CHANGELOG.md](../../CHANGELOG.md) summarizes cross-surface releases.
 
+## 1.2.0
+
+- Bundled commands: add `/iteration-loop` (autonomous Phase 1→5; optional `direction` + `scale`).
+- Bundled skills: `mstar-iteration` autonomous direction lock / scale budget / branch resolve + `references/autonomous-direction-lock.md`.
+
+See root [CHANGELOG.md](../../CHANGELOG.md) **1.2.0**.
+
+## 1.1.0
+
+- Bundled skills: raw QC/QA process reports default to gitignored `{SDD_DIR}/review/`; durable gate summaries and `status.json` residual findings are the tracked handoff surface. `{PLAN_DIR}/reports/` is legacy / explicit audit mode only.
+- Bundled skills: iteration compass template adds `Quality Gate Summary` for iteration-level QC/QA and residual rollups.
+
+See root [CHANGELOG.md](../../CHANGELOG.md) **1.1.0**.
+
 ## 1.0.6
 
 - Bundled skills: `mstar-sdd` pins L2 per-task reviewer to `generalPurpose`; forbids `qc-specialist*` at task scope.

package/README.md

@@ -28,7 +28,7 @@ npx @mstar-harness/cli init --target opencode
 |-----------------|----------|
 | `harness-skills/` | `mstar-harness-core`, `mstar-iteration`, `mstar-sdd`, roles, phase/dispatch gates, … |
 | `harness-agents/` | Role shells (`project-manager`, `fullstack-dev`, `qc-specialist`, …) |
-| `harness-commands/` | `/iteration-start`, `/iteration-drive`, `/mstar-bootstrap` |
+| `harness-commands/` | `/iteration-start`, `/iteration-drive`, `/iteration-loop`, `/mstar-bootstrap` |
 
 The plugin resolves **only paths inside this package** — not `process.cwd()/skills`, so your app repo root does not affect harness loading.
 
@@ -36,7 +36,7 @@ The plugin resolves **only paths inside this package** — not `process.cwd()/sk
 
 1. Install the plugin (above).
 2. In OpenCode, start with the **Project Manager** agent (`project-manager`).
-3. For a full iteration: run **`/iteration-start`**, then **`/iteration-drive`** when plans are ready.
+3. For a full iteration: run **`/iteration-start`** then **`/iteration-drive`**, or one-shot **`/iteration-loop`** (autonomous Phase 1→5).
 
 Entry skill: **`mstar-harness-core`** (loaded before other `mstar-*` skills).
 

package/harness-agents/qc-specialist-2.md

@@ -9,21 +9,17 @@ tools:
   edit: true
   bash: true
 permission:
-  # `edit` covers write/patch/multiedit. Only `.md` under resolved `{PLAN_DIR}/reports/` (default + legacy roots).
+  # `edit` covers write/patch/multiedit. Only `.md` under resolved `{SDD_DIR}/review/` bundle roots.
   edit:
     "*": deny
-    ".mstar/plans/reports/*.md": allow
-    ".mstar/plans/reports/**/*.md": allow
-    ".agents/plans/reports/*.md": allow
-    ".agents/plans/reports/**/*.md": allow
-    ".plans/reports/*.md": allow
-    ".plans/reports/**/*.md": allow
-    ".worktrees/**/.mstar/plans/reports/*.md": allow
-    ".worktrees/**/.mstar/plans/reports/**/*.md": allow
-    ".worktrees/**/.agents/plans/reports/*.md": allow
-    ".worktrees/**/.agents/plans/reports/**/*.md": allow
-    ".worktrees/**/.plans/reports/*.md": allow
-    ".worktrees/**/.plans/reports/**/*.md": allow
+    ".mstar/sdd/*.md": allow
+    ".mstar/sdd/**/*.md": allow
+    ".agents/sdd/*.md": allow
+    ".agents/sdd/**/*.md": allow
+    ".worktrees/**/.mstar/sdd/*.md": allow
+    ".worktrees/**/.mstar/sdd/**/*.md": allow
+    ".worktrees/**/.agents/sdd/*.md": allow
+    ".worktrees/**/.agents/sdd/**/*.md": allow
   bash:
     "*": deny
     # Git inspection (read-only)
@@ -35,9 +31,6 @@ permission:
     "git stash list*": allow
     "git branch*": allow
     "git status*": allow
-    # Versioning QC reports only (paths you edited must stay under allowed reports/ trees)
-    "git add*": allow
-    "git commit*": allow
     # JavaScript / TypeScript
     "eslint*": allow
     "npx eslint*": allow

package/harness-agents/qc-specialist-3.md

@@ -9,21 +9,17 @@ tools:
   edit: true
   bash: true
 permission:
-  # `edit` covers write/patch/multiedit. Only `.md` under resolved `{PLAN_DIR}/reports/` (default + legacy roots).
+  # `edit` covers write/patch/multiedit. Only `.md` under resolved `{SDD_DIR}/review/` bundle roots.
   edit:
     "*": deny
-    ".mstar/plans/reports/*.md": allow
-    ".mstar/plans/reports/**/*.md": allow
-    ".agents/plans/reports/*.md": allow
-    ".agents/plans/reports/**/*.md": allow
-    ".plans/reports/*.md": allow
-    ".plans/reports/**/*.md": allow
-    ".worktrees/**/.mstar/plans/reports/*.md": allow
-    ".worktrees/**/.mstar/plans/reports/**/*.md": allow
-    ".worktrees/**/.agents/plans/reports/*.md": allow
-    ".worktrees/**/.agents/plans/reports/**/*.md": allow
-    ".worktrees/**/.plans/reports/*.md": allow
-    ".worktrees/**/.plans/reports/**/*.md": allow
+    ".mstar/sdd/*.md": allow
+    ".mstar/sdd/**/*.md": allow
+    ".agents/sdd/*.md": allow
+    ".agents/sdd/**/*.md": allow
+    ".worktrees/**/.mstar/sdd/*.md": allow
+    ".worktrees/**/.mstar/sdd/**/*.md": allow
+    ".worktrees/**/.agents/sdd/*.md": allow
+    ".worktrees/**/.agents/sdd/**/*.md": allow
   bash:
     "*": deny
     # Git inspection (read-only)
@@ -35,9 +31,6 @@ permission:
     "git stash list*": allow
     "git branch*": allow
     "git status*": allow
-    # Versioning QC reports only (paths you edited must stay under allowed reports/ trees)
-    "git add*": allow
-    "git commit*": allow
     # JavaScript / TypeScript
     "eslint*": allow
     "npx eslint*": allow

package/harness-agents/qc-specialist.md

@@ -9,21 +9,17 @@ tools:
   edit: true
   bash: true
 permission:
-  # `edit` covers write/patch/multiedit. Only `.md` under resolved `{PLAN_DIR}/reports/` (default + legacy roots).
+  # `edit` covers write/patch/multiedit. Only `.md` under resolved `{SDD_DIR}/review/` bundle roots.
   edit:
     "*": deny
-    ".mstar/plans/reports/*.md": allow
-    ".mstar/plans/reports/**/*.md": allow
-    ".agents/plans/reports/*.md": allow
-    ".agents/plans/reports/**/*.md": allow
-    ".plans/reports/*.md": allow
-    ".plans/reports/**/*.md": allow
-    ".worktrees/**/.mstar/plans/reports/*.md": allow
-    ".worktrees/**/.mstar/plans/reports/**/*.md": allow
-    ".worktrees/**/.agents/plans/reports/*.md": allow
-    ".worktrees/**/.agents/plans/reports/**/*.md": allow
-    ".worktrees/**/.plans/reports/*.md": allow
-    ".worktrees/**/.plans/reports/**/*.md": allow
+    ".mstar/sdd/*.md": allow
+    ".mstar/sdd/**/*.md": allow
+    ".agents/sdd/*.md": allow
+    ".agents/sdd/**/*.md": allow
+    ".worktrees/**/.mstar/sdd/*.md": allow
+    ".worktrees/**/.mstar/sdd/**/*.md": allow
+    ".worktrees/**/.agents/sdd/*.md": allow
+    ".worktrees/**/.agents/sdd/**/*.md": allow
   bash:
     "*": deny
     # Git inspection (read-only)
@@ -35,9 +31,6 @@ permission:
     "git stash list*": allow
     "git branch*": allow
     "git status*": allow
-    # Versioning QC reports only (paths you edited must stay under allowed reports/ trees)
-    "git add*": allow
-    "git commit*": allow
     # JavaScript / TypeScript
     "eslint*": allow
     "npx eslint*": allow

package/harness-commands/iteration-loop.md

@@ -0,0 +1,297 @@
+---
+name: iteration-loop
+description: Autonomous full iteration loop for cloud agents — Phase 1 (code-first auto direction lock + compass/plans + Review & Edit chain) through Phase 2–5 (execute → close → PR → merge-ready). Optional args: direction, scale (S|M|L, default M). Not Done until Phase 5 exit checklist passes. Minimal human intervention; no grill-me.
+agent: project-manager
+---
+
+# Iteration Loop
+
+Run a **full** Morning Star iteration with minimal human intervention. **Done = Phase 5 §5.5 exit checklist 全 `[x]`** — not Phase 1 lock, not Phase 3 close, not Phase 4 PR open.
+
+**vs other commands:**
+
+| Command | Scope |
+|---------|--------|
+| `iteration-start` | Phase 1 only; **grill-me** with user |
+| `iteration-drive` | Phase 2→5 on an already locked iteration |
+| **`iteration-loop`** | Phase 1→5 end-to-end; **autonomous** direction lock |
+
+Phase gate SSOT → **`mstar-iteration`** §1–§5. This command is a **consumer**; it does not redefine skill semantics.
+
+## Args（最多 2 个）
+
+```
+/iteration-loop [direction] [scale]
+```
+
+| Arg | Meaning | Default |
+|-----|---------|---------|
+| `direction` | Iteration direction / feedback constraint (free text) | Code-first research → **auto-lock recommended** |
+| `scale` | `S` \| `M` \| `L` | **`M`** |
+
+**Scale budget**（写入 compass；约束 **业务** plan 数量）→ **`mstar-iteration`** §1.2 + `references/autonomous-direction-lock.md`：
+
+- **S** → 1 business plan
+- **M** → 2–3 business plans
+- **L** → 3–4 business plans（默认上限 4，除非 `direction` 显式要求更大）
+
+**HARD**：budget **只计**实际业务交付 plan；**不计** harness 流程（Review 链、QC/QA、compound、close、PR、merge-ready、compass/`status.json` 维护等）。流程门禁仍须执行，但不占 S/M/L 名额，也不得写成独立 process plan 来“凑数/占坑”。
+
+Parse: if the last token is exactly `S`/`M`/`L` (case-insensitive), treat it as `scale`; remaining text is `direction`. If only one token and it is `S`/`M`/`L`, that is `scale` with empty `direction`.
+
+## Phase state machine（禁止跳步）
+
+```
+Phase 1: Autonomous start  →  Phase 2: Autonomous Execute  →  Phase 3: close  →  Phase 4: PR  →  Phase 5: merge-ready
+```
+
+| 当前状态 | 允许 | 禁止 |
+|----------|------|------|
+| Phase 1 未 lock | Research → auto-lock → Review chain → integration | 进入 Phase 2 implement；grill-me |
+| compass `locked` + plans registered | **立刻** Phase 2 | 问用户「是否开始 execute」 |
+| 存在非 `Done` plan | Phase 2 dispatch | 进入 Phase 3 或开 PR |
+| **全部** plan `Done` | **立刻** Phase 3 | 宣称 loop 完成、开 PR |
+| Phase 3 exit 全 `[x]` + compass `completed` | Phase 4 | 跳过 compound |
+| PR 已创建 | Phase 5 loop | 汇报结束 |
+| Phase 5 exit 全 `[x]` | **iteration-loop Done** | — |
+
+## Continuous execution（HARD — Phase 1 lock 后至 Phase 5 exit）
+
+自 Phase 1 §6 integration 完成起，至 Phase 5 §5.5 全 `[x]` 前，PM **连续编排**。
+
+| 禁止 | 必须 |
+|------|------|
+| 方向 / plan / phase 边界例行 yes/no（「是否同意该方向」「要不要继续」「是否开 PR」） | 进度摘要后**下一条** = dispatch 或下一 phase 步骤 |
+| 用 Phase 汇报收束 turn 后等待用户 | Phase 1 lock → **立刻** Phase 2；plan Done → 下一 plan 或 Phase 3 |
+| 跨 plan 并行 implement | Per-plan **串行** |
+
+**合法 STOP（仅此升级用户）**：
+
+- Branch metadata 按 **`mstar-iteration`** autonomous resolve 顺序仍无法确定（**禁止**静默默认 `main`/`master`）
+- 代码/roadmap **无可信候选**且无 `direction` 参数
+- **`Blocked`**：真冲突、secrets、不可逆范围缺口、Phase 5 多轮仍无法 merge-ready
+- 用户本轮显式打断
+
+**Turn 收束纪律**：最后一条内容必须是 **in-flight 动作**（invoke 已发出或下一 Assignment），**不得**以确认问句结尾。
+
+## PM invariants
+
+### Phase 1（Review & Edit）
+
+| 禁止（PM 线程） | 必须 |
+|-----------------|------|
+| 自己 Edit 冒充 product-manager / architect / writing-specialist | §5.1 → §5.2 → §5.3 **顺序**各 **1 次 invoke** |
+| 只写 Assignment 就声称 review 完成 | 几条角色 ⇒ 几条 invoke |
+| §5 完成前 commit / 创建 integration | 5.4 PM lock 在 subagent 返回之后 |
+| 加载 `grill-me` | **Autonomous** direction lock（`mstar-iteration` §1.2） |
+
+### Phase 2–5
+
+| 禁止（PM 线程） | 必须 |
+|-----------------|------|
+| Write/Edit/Shell 产品代码、写测试、跑 QC | 每条 implement/QC/QA Assignment ⇒ **1 次 `Task`** |
+| 多 task plan inline 大包派发 | **SDD** per-task 循环 |
+| 最后 plan `Done` 后直接开 PR | **Phase 3 → 4 → 5** |
+| Phase 5 自己改产品代码 | dispatch `fullstack-dev` / `ops-engineer` |
+
+派发细则 → **`mstar-dispatch-gates`** + **`mstar-host`**。
+
+**Session todos**：
+
+| Todo id | 何时追加 | 何时可勾掉 |
+|---------|----------|------------|
+| `phase-1-autonomous-start` | Boot | compass `locked` + integration committed |
+| plan-wave todos | 进入 Phase 2 | 各 plan `Done` |
+| `phase-3-iteration-close` | 仅剩 1 个非 `Done` plan | Phase 3 §3.5 exit 全 `[x]` |
+| `phase-4-create-pr` | Phase 3 完成后 | PR 已创建 |
+| `phase-5-pr-merge-ready` | Phase 4 完成后 | Phase 5 §5.5 exit 全 `[x]` |
+
+## Boot
+
+1. `mstar-harness-core`
+2. `mstar-roles` → `references/project-manager.md`
+3. `mstar-iteration` → **§ Phase 1**（含 **autonomous** direction lock / scale budget / branch resolve）+ **§ Phase 2–5**
+4. `mstar-dispatch-gates`
+5. `mstar-phase-gates` → Prepare
+6. `mstar-plan-conventions`, `mstar-plan-artifacts`
+7. `mstar-host` → active host reference
+8. `mstar-compound` — before Phase 3 §3.2
+9. **`mstar-sdd`** — before first implement dispatch in Phase 2
+10. `mstar-review-qc` — before first QC dispatch in Phase 2
+11. `mstar-branch-worktree` — when Git/write or QC checkout
+
+**Do not** Read `skills/grill-me/SKILL.md` for this command.
+
+---
+
+## Phase 1: Autonomous start
+
+### 1. Research
+
+Survey structured and unstructured sources（code-first — **explore before guessing**）:
+
+**Structured:**
+- `{HARNESS_DIR}/status.json` → active plans, deferred, residuals
+- `{ITERATION_DIR}/` → prior compasses, roadmap batches
+- `{KNOWLEDGE_DIR}/` → design / architecture notes
+- `{SPECS_DIR}/` → specs, gaps
+
+**Unstructured — Glob then Read:**
+- `**/roadmap*.md`, `**/ROADMAP*.md`, `**/*-roadmap.md`
+- `**/deferred*.md`, `**/DEFERRED*.md`
+- `**/features*.md`, `**/FEATURES*.md`
+- `**/backlog*.md`, `**/TODO*.md`, `**/todo*.md`, `**/*.plan.md`
+
+Prioritize deferred / incomplete items from prior iterations. Read `STRATEGY.md` if present.
+
+### 2. Explore Directions
+
+Scope **2–4** candidates targeting product completeness; each with goals + trade-offs. Prefer deferred / roadmap `next` items.
+
+### 3. Lock Direction — autonomous（NOT grill-me）
+
+**Direction lock mode: `autonomous`**（显式 opt-in → **`mstar-iteration` §1.2**）。
+
+Execute **`mstar-iteration` §1.2 autonomous** direction lock（detail: `references/autonomous-direction-lock.md`）：
+
+1. If `direction` arg present → constrain candidates to that intent; pick the best evidence-backed fit.
+2. If absent → rank candidates（deferred/roadmap next > STRATEGY alignment > product completeness > risk）and **lock the recommended** direction.
+3. Write to compass: locked direction, rationale, success criteria, non-goals, scale budget.
+4. Resolve delivery branch policy via **autonomous branch resolve**（`references/autonomous-direction-lock.md`）— never silent `main`/`master`.
+
+**Do not** ask the user to confirm the chosen direction. Record rationale on disk instead.
+
+**STOP** if no credible candidate and no `direction` arg, or branch policy unresolved after resolve order.
+
+### 4. Write Compass & Plans
+
+Per **`mstar-iteration` §1.3–§1.5**（template: `iteration-compass-template.md`）:
+
+- Compass with `iteration_base_branch`, `target_branch`, `status: active`, scale budget noted in Scope / Plans
+- **Business** plan count within scale budget（exclude harness process from the count）
+- Register plans in `status.json`; update `{ITERATION_DIR}/README.md`
+
+### 5. Review & Edit Chain（HARD GATE）
+
+**顺序（HARD）**：`product-manager` → `architect` → `writing-specialist` → PM lock。**禁止**并行三角色。OpenCode：plain role id — **`mstar-host/references/opencode.md`** § Role-mention hygiene.
+
+| # | Role | Required action |
+|---|------|-----------------|
+| 5.1 | **product-manager** | invoke: **edit** compass, plans, `{SPECS_DIR}/`, `{ITERATION_DIR}/<iteration-id>/` — **禁止** `{KNOWLEDGE_DIR}/` 新增 |
+| 5.2 | **architect** | invoke: **edit** compass, plans, specs / workspace（含 5.1 后版本）— **禁止** knowledge 新增 |
+| 5.3 | **writing-specialist** | invoke: edit docs + **specs corpus hygiene** — `iteration-artifact-boundaries.md` + `iteration-corpus-hygiene.md` |
+| 5.4 | **project-manager** | Merge; **lock** compass (`status: locked`); confirm Prepare gates |
+
+Tool rule → **`mstar-dispatch-gates`** specialist review-and-edit（顺序链）。Exception: user waives ("PM-only review").
+
+### iteration-loop Phase 1 pre-commit checklist
+
+Print before §6; all must be `[x]`:
+
+- [ ] Autonomous direction lock rationale recorded in compass（not grill-me）
+- [ ] Scale budget applied; **business** plan count within S/M/L（harness process not counted）
+- [ ] Draft compass + plans + `status.json` registered
+- [ ] product-manager invoke completed；**未**向 `{KNOWLEDGE_DIR}/` 新增
+- [ ] architect invoke completed；**未**向 `{KNOWLEDGE_DIR}/` 新增
+- [ ] writing-specialist invoke completed；specs corpus hygiene done
+- [ ] PM final lock: compass `status: locked`; Prepare gates pass
+- [ ] Branch policy locked: `iteration_base_branch`, `spec_integration_branch`, `target_branch` in compass / `status.json`
+- [ ] **THEN**: git commit + push `iteration/<iteration-id>`
+
+### 6. Integration Branch
+
+**Precondition**: §5 complete.
+
+```bash
+git fetch origin   # if needed
+git checkout -b <spec_integration_branch> <iteration_base_branch>
+# or: git checkout <spec_integration_branch>  if it already exists
+```
+
+Register branch fields in compass + `status.json`. Commit docs; push.
+
+**STOP** if `iteration_base_branch` or `target_branch` still missing after autonomous resolve.
+
+**Immediately** print `## Phase 2: Autonomous Execute` → continue below（勾掉 `phase-1-autonomous-start`）。
+
+---
+
+## Phase 2: Autonomous Execute
+
+**Continuous execution applies.** Branch policy first（`mstar-iteration` §2.3）.
+
+Execute **`mstar-iteration` § Phase 2** exactly. Summary:
+
+1. Precondition gate §2.0（four checks）
+2. Session todos §2.1
+3. Read backlog §2.2
+4. Integration branch §2.3
+5. Per-plan loop §2.4 — **SDD** default; serial implementer → task reviewer; QC **full tri-review** N=3; QA gate; merge to integration; next plan
+6. All plans `Done` → print `## Phase 3: iteration-close` → **`mstar-iteration` §3**（不得开 PR）
+
+派发纪律 → **`mstar-dispatch-gates`** + **`mstar-iteration` §2.5**。
+
+## Phase 3: iteration-close
+
+当 every plan 为 `Done`：
+
+1. STOP per-plan loop
+2. Print `## Phase 3: iteration-close`
+3. Execute **`mstar-iteration` §3.0→§3.5**（compound + workspace promotion）
+4. Exit checklist `[x]` + compass `completed` → print `## Phase 4: Create PR`
+
+```bash
+git add {ITERATION_DIR}/ {KNOWLEDGE_DIR}/ CONCEPTS.md
+git commit -m "chore(iteration): close <iteration-id> — compound round, roadmap update"
+git push origin <spec_integration_branch>
+```
+
+## Phase 4: Create PR
+
+Execute **`mstar-iteration` § Phase 4**：
+
+1. Print `## Phase 4: Create PR`
+2. Resolve `metadata.target_branch`（compass fallback）；missing → STOP；never default `main`
+3. Create PR: `spec_integration_branch` → `target_branch`
+4. Record URL/number；勾掉 `phase-4-create-pr`
+5. **Immediately** print `## Phase 5: PR merge-ready` → Phase 5
+
+## Phase 5: PR merge-ready
+
+Execute **`mstar-iteration` § Phase 5**。**§5.5 exit 全 `[x]` = iteration-loop Done.**
+
+### 5.0 Discover optional helper skills（non-`mstar-*`）
+
+| Skill | Search paths（示例） |
+|-------|----------------------|
+| `greploop` | `skills/greploop/SKILL.md`；`~/.cursor/skills-cursor/greploop/SKILL.md`；`~/.agents/skills/greploop/SKILL.md` |
+| `babysit` | `skills/babysit/SKILL.md`；`~/.cursor/skills-cursor/babysit/SKILL.md`；`~/.agents/skills/babysit/SKILL.md` |
+
+| Priority | Condition | Primary done signal |
+|----------|-----------|---------------------|
+| 1 | `greploop` found | Greptile **5/5** |
+| 2 | else `babysit` | Required CI green + reviews resolved |
+| 3 | else neither | Same as babysit（本 command fallback） |
+
+Both present: greploop to 5/5, then babysit（串行）.
+
+### 5.1–5.4 Loop
+
+Same hygiene as drive consumer pattern: status → conflicts → reviews → CI → mode pass → comment+resolve on addressed threads → repeat until §5.5.
+
+Fixes push to `spec_integration_branch` only. PM does not rewrite product code in-thread.
+
+### 5.5 Phase 5 exit checklist（iteration-loop Done）
+
+与 **`mstar-iteration` §5.2** 对齐：
+
+- [ ] PR mergeable
+- [ ] All **required** CI checks green on latest head
+- [ ] All review threads **resolved**（或用户书面 waive）
+- [ ] Greptile **5/5**（若 greploop mode / repo 可见分数）
+- [ ] Review comment + resolve 已覆盖本轮 addressed feedback
+- [ ] Host todo `phase-5-pr-merge-ready` 可勾选
+
+**Then** report: iteration id, locked direction + scale, plans completed, compound summary, PR link, merge-ready evidence.
+
+PR merge itself may remain manual unless user authorized auto-merge.

package/harness-commands/iteration-start.md

@@ -65,6 +65,8 @@ Explore candidate directions targeting **product completeness**:
 
 ## 3. Lock Direction — bundled `grill-me`
 
+**Direction lock mode: `interactive`**（`mstar-iteration` §1.2 默认；本命令不使用 `autonomous`）。
+
 This command bundles a **non-`mstar-*`** skill at `skills/grill-me/SKILL.md`. **Only this command step** references it — **do not** load it from `mstar-harness-core` or other `mstar-*` skills.
 
 **Before this step:** Read `skills/grill-me/SKILL.md`.

package/harness-skills/mstar-branch-worktree/SKILL.md

@@ -139,10 +139,10 @@ description: Morning Star business-repo Git feature branches, same-repo concurre
 
 - **`project-manager`** 分派 **QC** 时须在 Assignment 写明与待审实现一致的 **`Working branch`**，并写明 **`Review cwd` / `Worktree path`**：**优先**沿用开发 **Completion Report** 中回报的业务仓 **实现检出路径**（即「该 feature 的 worktree」）**当且仅当**该路径上的检出分支 **`HEAD` 已包含本轮待审的全部提交**（含曾发生在其他并行 worktree、现已归并到该分支的变更）。否则 **必须**改用 **集成完成后的** `Working branch` 与对应检出路径（或在该分支上 **另开** 审查专用 worktree）。若开发未用 worktree，则写明单一明确的业务仓根路径。若审查需与开发目录 **物理分离** 但仍审 **同一分支**，可指示在 **`Working branch`** 上 **另加** 一个 worktree 专供审查（只读使用业务仓）。**多流并行开发**时的前置归并、**推荐默认编排（plan 集成分支先行）** 与误派禁令见上一小节。
 - **三票审同一功能（强制对齐）**：分派 **QC 三审**时，除上述字段外，**必须**在 **三份 Assignment 中逐字写入相同**的 **`plan_id`** 与 **`Review range` / `Diff basis`**：
-  - **`plan_id`**：与 `{PLAN_DIR}/reports/<plan-id>/` 及主 **Plan Path** 一致；无 `{PLAN_DIR}` 流程时写 **`plan_id: N/A`**，并另给一行 **`Feature / scope label`**（不可歧义，足以与并行其它 feature 区分）。
+  - **`plan_id`**：与 `{SDD_DIR}` 的 `<plan-id>` 段、主 **Plan Path**、`status.json.plans[].id` 一致；无 `{PLAN_DIR}` 流程时写 **`plan_id: N/A`**，并另给一行 **`Feature / scope label`**（不可歧义，足以与并行其它 feature 区分）。
   - **`Review range` / `Diff basis`**：明确本次审查所针对的 **diff/提交范围**（例如 `merge-base: <target_branch-or-base-ref>` + `tip: HEAD`；或 `rev-range: <full-40>..<full-40>`；或一句 `equivalent to: git diff <merge-base>...HEAD`，以团队可复现为准）。**三名 reviewer 的 Assignment 间该字段必须完全一致**；**`qa-engineer`** 验证同一 feature 时 **复用同一 `plan_id` 与同一 `Review range` / `Diff basis`**。**热修 / QC 单审**路径也须含 **同一组字段**，仅承接方份数为 1。
 - **三审并行**时，三名 reviewer **共用同一组 `Review cwd` / `Worktree path` + `Working branch` + `plan_id` + `Review range` / `Diff basis`**（对业务仓只读分析）；**一般不必**为每位 reviewer 各开一个 worktree，除非宿主或执行环境要求进程级隔离。
-- QC 的 **报告落盘**仍仅限 `{PLAN_DIR}/reports/`；上述约定保证 `git diff`、`git log`、lint 与所读文件与 **待合并 feature** 一致。
+- QC 的 **报告落盘**默认仅限 Assignment 指定的 `{SDD_DIR}/review/`；上述约定保证 `git diff`、`git log`、lint 与所读文件与 **待合并 feature** 一致。PM 另行提交主 plan gate summary / `status.json` residual changes as durable artifacts.
 - **`project-manager`** 分派 **`qa-engineer`** 时（仅 **`QA gate: mandatory`**），Assignment 须与 QC **逐字相同**的 **`Review cwd` / `Worktree path`**、**`Working branch`**、**`plan_id`**、**`Review range` / `Diff basis`**（QC 已写清则 QA 照抄）。**`qa-engineer`** 执行业务仓命令前须核对检出与分支；Report-only 且无路径依赖时，回报须说明验证环境，否则 `Blocked`。
 - 若 **QA 与同仓其他可写角色并发**提交测试代码，仍须遵守上文「同仓并发写入」的 **worktree** 规则（可为 QA 单开一条写入 worktree，**同一 `Working branch`**，由 PM 在 Assignment 写明）。
 

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

@@ -54,8 +54,8 @@ description: Morning Star 派发与委派门禁 —— 仅 PM 可增派 subagent
 当 PM 声明「并发分派」时，须同时满足**文案并发**与**工具并发**：
 
 - **工具并发**：同一调度轮次内，多个 subagent 调用须在**同一条 assistant 消息**里一次性发出（宿主允许时）。
-- **QC tri-review（SDD 强制）**：`Execution mode: sdd` 且全部 task 完成后 → `qc-specialist` / `qc-specialist-2` / `qc-specialist-3` 同条消息 **N=3**（`qc1`…`qc3` + `qc-consolidated.md`）。Assignment 须含 branch **review-package** 路径。适用于**单 plan 与 iteration**。
-- **QC 单席（例外）**：`Execution mode: inline`（hotfix 等），或 Assignment 显式 `QC mode: single` / `QC mode: single — override: <reason>` → `qc-specialist` ×1，`N=1`，`qc.md`。
+- **QC tri-review（SDD 强制）**：`Execution mode: sdd` 且全部 task 完成后 → `qc-specialist` / `qc-specialist-2` / `qc-specialist-3` 同条消息 **N=3**（写 `{SDD_DIR}/review/qc1.md`…`qc3.md`；PM 汇总 `qc-consolidated.md` + durable plan summary）。Assignment 须含 branch **review-package** 路径与 report paths。适用于**单 plan 与 iteration**。
+- **QC 单席（例外）**：`Execution mode: inline`（hotfix 等），或 Assignment 显式 `QC mode: single` / `QC mode: single — override: <reason>` → `qc-specialist` ×1，`N=1`，写 `{SDD_DIR}/review/qc.md`。
 - **QC targeted re-review**：Assignment 含 **`QC re-review: targeted — reviewers: …`** 时，**N** = 所列席位数（1–3），同条消息发满 **N**。
 - **先自检再发送**：发送前核对「Assignment 条数 = 本条消息中的实际 **派发** 调用条数」。
 - **前置步骤与派发回合分离（防串行 rollout）**：为派发准备的 **`bash` / `read` / `glob` / `grep`**（如 `merge-base`、`Review range`、`git rev-parse`）**不计入** `N` 次派发；可在上一条仅含准备的消息完成。准备完成后，**下一条派发消息**须**一次性**含 **`N` 次** Task / subagent invoke。**禁止**先发 `1` 次、等返回再补发其余 `N-1` 次。
@@ -73,7 +73,7 @@ When **`Execution mode: sdd`** (`mstar-sdd`):
 - **`SDD implementer session: sticky`**：same implementer subagent may **resume** across tasks when host supports it; **reviewers never resume** — see **`mstar-sdd/references/sticky-implementer-session.md`**.
 - File handoffs only — no pasted plan/diff/history in dispatch prompts.
 - Record per-task BASE SHA; use `review-package` for diffs — **never `HEAD~1`**.
-- After all tasks: branch `review-package` → **mandatory tri-review N=3** when `Execution mode: sdd`; **N=1** only for `inline` / explicit single override.
+- After all tasks: branch `review-package` in `{SDD_DIR}/review/` → **mandatory tri-review N=3** when `Execution mode: sdd`; **N=1** only for `inline` / explicit single override.
 
 ## 并行规则（摘要）
 

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

@@ -39,7 +39,7 @@ description: Morning Star (启明星) harness **强制全局入口** —— 信
 | 角色 | 始终 | 按任务追加（典型） |
 |------|------|-------------------|
 | **全部** | 本 skill | — |
-| **`@project-manager`** | 本 skill | `mstar-dispatch-gates`、`mstar-phase-gates`、`mstar-plan-conventions`、`mstar-roles`；implement 波次 `mstar-sdd`；派 QC 前 `mstar-review-qc`；并行/审查 `mstar-branch-worktree`；plan/status/reports `mstar-plan-artifacts`；UI 类 plan Prepare 阶段 `mstar-design-md`（DESIGN.md 门禁）；新建/大改 skill 时 `mstar-skill-authoring`；迭代管理 `mstar-iteration`（Phase 1–5）；战略性工作 `mstar-strategy`。**不**读 `mstar-coding-behavior` |
+| **`@project-manager`** | 本 skill | `mstar-dispatch-gates`、`mstar-phase-gates`、`mstar-plan-conventions`、`mstar-roles`；implement 波次 `mstar-sdd`；派 QC 前 `mstar-review-qc`；并行/审查 `mstar-branch-worktree`；plan/status/review bundle `mstar-plan-artifacts`；UI 类 plan Prepare 阶段 `mstar-design-md`（DESIGN.md 门禁）；新建/大改 skill 时 `mstar-skill-authoring`；迭代管理 `mstar-iteration`（Phase 1–5）；战略性工作 `mstar-strategy`。**不**读 `mstar-coding-behavior` |
 | **实现/审查/运维** | 本 skill + `mstar-coding-behavior` + 角色 ref | 有 git 写：`mstar-branch-worktree`；有 plan 路径：`mstar-plan-conventions`；**PM** 派 QC 前：`mstar-review-qc`；**`qc-specialist*`**：`mstar-roles` → `references/qc-specialist/`；`qa-engineer`：`references/qa-engineer/`；改 status/residual：`mstar-plan-artifacts`；UI：`mstar-design-md`；知识库：`mstar-compound`（PM） |
 | **leaf 承接方** | 上栏 + **`mstar-dispatch-gates`**（反递归节） | — |
 
@@ -92,7 +92,7 @@ PM 在 Assignment 写 **`Task category`**（主类 + 可选 `secondary`）：
 | `mstar-sdd` | Subagent-driven development：file handoff、per-task review、ledger |
 | `mstar-branch-worktree` | 功能分支、worktree、QC/QA 检出对齐 |
 | `mstar-plan-conventions` | `{HARNESS_DIR}` 发现、初始化、Spec 分支模型摘要、产物路径 SSOT |
-| `mstar-plan-artifacts` | 主 plan、reports、`status.json`、residual、knowledge、Done 归档 |
+| `mstar-plan-artifacts` | 主 plan、review bundle / durable summaries、`status.json`、residual、knowledge、Done 归档 |
 | `mstar-design-md` | DESIGN.md 设计系统规范 —— 创建/审计/维护 design tokens，三级检查清单，light/dark 双主题 |
 | `mstar-review-qc` | PM：QC tri 编排、residual 留档、四层边界；leaf 执行 → `mstar-roles/references/qc-specialist/` |
 | `mstar-coding-behavior` | Think / Simplicity / Surgical / Debugging / Review Feedback / Goal-Driven / Communication |

package/harness-skills/mstar-host/references/cursor-plan-mode-bridge.md

@@ -31,7 +31,7 @@ Cursor **Plan mode** uses **CreatePlan** and built-in plan todos for session UX.
 When plan management is required and directories are missing:
 
 1. Create `{HARNESS_DIR}` and `{PLAN_DIR}`.
-2. Create `{PLAN_DIR}/reports/`.
+2. Ensure `{HARNESS_DIR}/sdd/` is gitignored; per-plan review bundles are created under `{SDD_DIR}/review/` when needed.
 3. Create `{HARNESS_DIR}/archived/residuals/`.
 4. Initialize `{HARNESS_DIR}/status.json` from `mstar-plan-artifacts/templates/status.empty.json` if missing.
 5. Optional: `{HARNESS_DIR}/notes.json` from `templates/notes.empty.json`, `{HARNESS_DIR}/knowledge/README.md`.
@@ -46,7 +46,7 @@ Full PM checklist: `mstar-roles/references/project-manager/plan-management.md`.
 
 | Todo ID (use in title) | Goal | On-disk outcome |
 |------------------------|------|-----------------|
-| **`harness-init`** | Bootstrap harness tree | `{HARNESS_DIR}/`, `{PLAN_DIR}/`, `reports/`, `archived/residuals/`, `status.json` initialized |
+| **`harness-init`** | Bootstrap harness tree | `{HARNESS_DIR}/`, `{PLAN_DIR}/`, `sdd/` gitignore, `archived/residuals/`, `status.json` initialized |
 | **`spec-register`** | Register plan in SSOT | New `plans[]` row in `status.json` (`id`, `status`, `file`, `metadata`); spec stub in `{SPECS_DIR}` or plan frontmatter |
 | **`mirror-plan`** | SSOT main plan file | `{PLAN_DIR}/<plan-id>-<name>.md` with task checkboxes aligned to CreatePlan body |
 
@@ -107,7 +107,7 @@ Use this structure in CreatePlan `plan` markdown; mirror the same sections into
 
 ### Bootstrap (fixed prefix — complete before implement)
 
-1. harness-init — init .mstar/, status.json, reports/, archived/residuals/
+1. harness-init — init .mstar/, status.json, sdd/ gitignore, archived/residuals/
 2. spec-register — register plan_id in status.json; spec stub if applicable
 3. mirror-plan — write .mstar/plans/<plan-id>-<short-name>.md
 
@@ -198,6 +198,6 @@ When `/pm` runs under Plan mode:
 ## Related skills
 
 - `mstar-plan-conventions` — discovery, init, plan-writing path gate
-- `mstar-plan-artifacts` — `status.json`, reports, checkboxes, residual
+- `mstar-plan-artifacts` — `status.json`, review bundle summaries, checkboxes, residual
 - `mstar-phase-gates` — Prepare / Execute order
 - `mstar-roles/references/project-manager/dispatch-and-assignment.md` — Checkpoint: commit → Completion Report → Status Update

package/harness-skills/mstar-host/references/cursor.md

@@ -19,7 +19,7 @@ Before first **CreatePlan**: Read `mstar-plan-conventions`, `mstar-plan-artifact
 
 | Todo ID | Purpose |
 |---------|---------|
-| `harness-init` | Init `{HARNESS_DIR}`, `{PLAN_DIR}`, `reports/`, `archived/residuals/`, `status.json` |
+| `harness-init` | Init `{HARNESS_DIR}`, `{PLAN_DIR}`, `sdd/` gitignore, `archived/residuals/`, `status.json` |
 | `spec-register` | Register `plan_id` in `status.json.plans[]` + spec stub if applicable |
 | `mirror-plan` | Write SSOT main plan under `{PLAN_DIR}/` |
 

package/harness-skills/mstar-host/references/parallel-dispatch.md

@@ -29,8 +29,8 @@ Printing `## Assignment` in the main thread **without** matching host invocation
 
 ## QC default (initial wave)
 
-- **`Execution mode: sdd`**: **N=3** tri-review + branch review-package path → `qc1`…`qc3` + consolidated.
-- **`inline` / override**: **N=1** → `qc.md`.
+- **`Execution mode: sdd`**: **N=3** tri-review + branch review-package path → `{SDD_DIR}/review/qc1.md`…`qc3.md` + consolidated.
+- **`inline` / override**: **N=1** → `{SDD_DIR}/review/qc.md`.
 
 ## QC iteration / SDD (same rule)
 
@@ -55,7 +55,7 @@ Formal iteration Phase 2 uses the same SDD + tri rule — not a separate carve-o
 
 - Assignment: **`QC re-review: targeted — reviewers: <role-ids>`** → **N** = listed seats only (1–3), **one** dispatch turn with **N** invocations.
 - Do **not** default to three invocations after a routine fix round.
-- Post-dispatch: verify only **dispatched** seats returned; PM updates same `qc-consolidated.md` (see `mstar-plan-artifacts/references/plan-files-and-reports.md`).
+- Post-dispatch: verify only **dispatched** seats returned; PM updates same bundle `qc-consolidated.md` and durable plan summary (see `mstar-plan-artifacts/references/plan-files-and-reports.md`).
 
 ## Self-check before send