@mstar-harness/opencode 0.5.1 → 0.6.1

package/INSTALL.md

@@ -25,8 +25,7 @@ Restart OpenCode. The plugin installs from npm and registers Morning Star runtim
 
 - Keep your role models and permissions in `opencode.json`.
 - The plugin loads **only paths inside the `@mstar-harness/opencode` package**:
-  - **`harness-skills/`** — copy of Morning Star `skills/` from the release build (`prepublishOnly` runs `bundle-assets` before `bun build`).
-  - **`skills/`** — packaged OpenCode host adapter (e.g. `mstar-host`).
+  - **`harness-skills/`** — copy of repo `skills/` from the release build (`prepublishOnly` runs `bundle-assets` before `bun build`), including **`mstar-host`**.
   - **`harness-agents/`** — copy of repo `agents/` from the same build.
 - It does **not** read `<cwd>/skills` or `<cwd>/agents`, so OpenCode’s `process.cwd()` (your app project root) does not affect harness resolution.
 - Bootstrap prompt entry is injected once with `<IMPORTANT_FOR_HARNESS>`.

package/dist/mstar.js

@@ -6,17 +6,13 @@ import { fileURLToPath } from "node:url";
 var __dirname2 = path.dirname(fileURLToPath(import.meta.url));
 var packageRoot = path.resolve(__dirname2, "..");
 var bundledSkillsDir = path.join(packageRoot, "harness-skills");
-var hostSkillsDir = path.join(packageRoot, "skills");
 var bundledAgentsDir = path.join(packageRoot, "harness-agents");
 var bootstrapAgentsPath = path.join(packageRoot, "AGENTS.md");
 var BOOTSTRAP_MARKER = "IMPORTANT_FOR_HARNESS";
 function resolveSkillPathCandidates() {
-  const out = [];
   if (fs.existsSync(bundledSkillsDir))
-    out.push(bundledSkillsDir);
-  if (fs.existsSync(hostSkillsDir))
-    out.push(hostSkillsDir);
-  return out;
+    return [bundledSkillsDir];
+  return [];
 }
 var extractFrontmatterAndBody = (content) => {
   const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);

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

@@ -1,6 +1,6 @@
 ---
 name: mstar-dispatch-gates
-description: Morning Star 派发与委派门禁 —— 仅 PM 可增派 subagent、`Execute as` 与 `Delegation`、承接方反递归 NEVER 红线、同条消息 N 次 invoke、QC 三审禁止串行 rollout、Assignment 文案≠派发（invoke 条数须对齐）、未齐不发（emit zero until batch-ready）。**必须**在 `@project-manager` 每轮派发、QC 三审并发、双轨 implement、或 leaf 角色疑惑能否 Task 时 Read；所有非 PM 承接方动手前必读反递归与自检。同仓 worktree 与 QC 检出对齐见 `mstar-branch-worktree`。Superpowers 并行短语见 `mstar-superpowers-align`。宿主细则见 `mstar-host-opencode` / `mstar-host-cursor`。
+description: Morning Star 派发与委派门禁 —— 仅 PM 可增派 subagent、`Execute as` 与 `Delegation`、承接方反递归 NEVER 红线、同条消息 N 次 invoke、QC 三审禁止串行 rollout、Assignment 文案≠派发（invoke 条数须对齐）、未齐不发（emit zero until batch-ready）。**必须**在 `@project-manager` 每轮派发、QC 三审并发、双轨 implement、或 leaf 角色疑惑能否 Task 时 Read；所有非 PM 承接方动手前必读反递归与自检。同仓 worktree 与 QC 检出对齐见 `mstar-branch-worktree`。Superpowers 并行短语见 `mstar-superpowers-align`。宿主细则见 `mstar-host`（`references/parallel-dispatch.md` 与各宿主 reference）。
 ---
 
 ## Load order（必读顺序）
@@ -43,7 +43,7 @@ description: Morning Star 派发与委派门禁 —— 仅 PM 可增派 subagent
 - **QC 三审硬门禁**：`qc-specialist` / `qc-specialist-2` / `qc-specialist-3` 须**同一条消息**全部发起；只发其中一个 = **`dispatch incomplete`**，不得写「三审已并行启动」。
 - **先自检再发送**：发送前核对「Assignment 条数 = 本条消息中的实际 **派发** 调用条数」。
 - **前置步骤与派发回合分离（防串行 rollout）**：为派发准备的 **`bash` / `read` / `glob` / `grep`**（如 `merge-base`、`Review range`、`git rev-parse`）**不计入** `N` 次派发；可在上一条仅含准备的消息完成。准备完成后，**下一条派发消息**须**一次性**含 **`N` 次** Task / subagent invoke。**禁止**先发 `1` 次、等返回再补发其余 `N-1` 次。
-- **未齐不发（emit zero until batch-ready）**：需并发 `N≥2` 而当前只能发 `1` 条时，本条应发 **`0` 条派发 invoke`**（可继续 read/bash 补齐），**禁止**「先发一个顶一下」；`N` 份 payload 就绪后**单次消息发满 `N`**。OpenCode 见 **`mstar-host-opencode`**「OpenCode PM: dispatch order」。
+- **未齐不发（emit zero until batch-ready）**：需并发 `N≥2` 而当前只能发 `1` 条时，本条应发 **`0` 条派发 invoke`**（可继续 read/bash 补齐），**禁止**「先发一个顶一下」；`N` 份 payload 就绪后**单次消息发满 `N`**。见 **`mstar-host`** → `references/parallel-dispatch.md`（具备 invoke / Task / subagent 工具的宿主共用）。
 
 ### 具名 subagent 宿主：文案分派 ≠ 调度完成
 

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

@@ -85,14 +85,18 @@ PM 在 Assignment 写 **`Task category`**（主类 + 可选 `secondary`）：
 | `mstar-coding-behavior` | Think / Simplicity / Surgical / Goal-Driven |
 | `mstar-superpowers-align` | Superpowers × harness 优先级与短语 |
 | `mstar-roles` | 角色正文 hub |
+| `mstar-host` | 宿主适配（自动识别；`references/opencode.md` / `cursor.md` / `codex.md` / `parallel-dispatch.md`） |
 
 ## 宿主 `mstar-host`
 
+Read **`mstar-host`** after this skill; detect host per its table, then Read the matching reference.
+
 | 宿主 | 要点 |
 |------|------|
-| OpenCode | 根 `AGENTS.md` → 本 skill；`question`、`@explore` |
-| Cursor | 会话先 Read 本 skill；Task 并行 QC；Plan 模式双写 → `mstar-host-cursor` · `references/cursor-plan-mode-bridge.md` |
-| 其它 | 初始化时强制 Read 本 skill |
+| OpenCode | `question`、`@explore`、named-role invoke → `references/opencode.md` |
+| Cursor | Task 并行 QC；Plan 双写 → `references/cursor.md` · `cursor-plan-mode-bridge.md` |
+| Codex | plugin skills、sandbox/apply_patch/tool discovery；无 invoke 工具时不声称 subagent dispatch → `references/codex.md` |
+| 其它 | 同 `mstar-host` skill；按工具信号选 reference |
 
 ## 护栏（不变量）
 
@@ -123,7 +127,7 @@ PM 在 Assignment 写 **`Task category`**（主类 + 可选 `secondary`）：
 | residual 只写 plan 不写 SSOT | `mstar-plan-artifacts` |
 | 角色文件塞流程长文 | 用专题 skill |
 | 无证据宣称完成 | `mstar-coding-behavior` / verification |
-| CreatePlan 不落盘 / 无 `.agents` mirror | `mstar-host-cursor` · `cursor-plan-mode-bridge` |
+| CreatePlan 不落盘 / 无 `.agents` mirror | `mstar-host` · `cursor-plan-mode-bridge` |
 
 ## 可选：OpenViking Memory
 

package/harness-skills/mstar-harness-core/references/open-harness-principles.md

@@ -70,7 +70,7 @@
 
 ## 延伸阅读
 
-- 按能力选配 MCP/skills：当前宿主的 `mstar-host` skill 的「按能力选配」章节
+- 按能力选配 MCP/skills：OpenCode → `mstar-host` `references/opencode.md`；其它宿主见 `mstar-host` 检测表
 - Superpowers 与门禁对齐：`mstar-superpowers-align`
 - 库文档检索共享协议：`mstar-harness-core` `references/library-docs-protocol.md`
 - 跨角色编码行为准则（轻量、可复用）：`mstar-coding-behavior`

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

@@ -0,0 +1,49 @@
+---
+name: mstar-host
+description: Morning Star host adapter (OpenCode, Cursor, Codex). Use after mstar-harness-core whenever host entry, clarify, dispatch, or plan UX differs by platform - OpenCode question/@agent-id invoke, Cursor /pm and CreatePlan/SwitchMode dual-write and Task parallel QC, Codex plugin skills plus sandboxed tools/tool discovery. Auto-detect host from session tools; then Read references/<host>.md. Always load after mstar-harness-core.
+---
+
+# Morning Star Host Adapter
+
+Host-specific **capabilities and entry behavior** for Morning Star. Process gates and invariants stay in `mstar-harness-core` and topic `mstar-*` skills.
+
+## First action
+
+Read **`mstar-harness-core`** before this skill (even when the host injects project `AGENTS.md`).
+
+## Default path
+
+1. Read `mstar-harness-core`
+2. Read **`mstar-host`** (this skill) and detect host below
+3. Read **`references/<host>.md`** for the active host
+4. Load role via `mstar-roles`
+5. Execute with evidence-first completion checks
+
+Load topic skills **on demand** per `mstar-roles` (do not read every `mstar-*` skill by default). Cursor maint routing-eval: `.cursor/skills/mstar-routing-eval/` only.
+
+## Detect active host
+
+Use **capability signals** (not filesystem paths):
+
+| Signal | Host | Next read |
+|--------|------|-----------|
+| **CreatePlan** / **SwitchMode** available | `cursor` | `references/cursor.md`; Plan mode also `references/cursor-plan-mode-bridge.md` |
+| **`question`** tool or PM **`@<agent-id>`** subagent invoke | `opencode` | `references/opencode.md` |
+| **Task** + `subagent_type`, no CreatePlan | `cursor` | `references/cursor.md` |
+| **Codex app/CLI/plugin context**, `functions.*`, `codex_app.*`, `tool_search`, Browser plugin tools | `codex` | `references/codex.md` |
+| Still ambiguous | - | Read sections in **`cursor.md`**, **`opencode.md`**, and **`codex.md`** that match tools you have; **`mstar-harness-core` wins** on conflict |
+
+## Parallel dispatch (invoke-capable hosts)
+
+When PM dispatches **N >= 2** concurrent assignees (QC tri-review, dual-track implement, etc.) and the host exposes actual invoke / Task / subagent tools, read **`references/parallel-dispatch.md`** in the dispatch round (shared with `mstar-dispatch-gates`). Without a callable invoke tool, Assignment Markdown is not dispatch.
+
+## Library docs (Context7)
+
+Follow `mstar-harness-core` → `references/library-docs-protocol.md`.
+
+## Conflict order
+
+1. User explicit instructions (this turn)
+2. Project `AGENTS.md` / `CLAUDE.md`
+3. `mstar-harness-core` and related `mstar-*` skills
+4. This `mstar-host` skill and `references/*`

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

@@ -0,0 +1,56 @@
+# Codex host reference
+
+Load when **`mstar-host`** detection resolves **codex** (Codex app/CLI session, Codex plugin installed from `.codex-plugin/plugin.json`, or Codex tool namespaces such as `functions.*`, `codex_app.*`, `tool_search`, `image_gen`, or Browser plugin tools).
+
+Parallel PM dispatch: read **`parallel-dispatch.md`** only when Codex exposes an actual multi-agent / Task-style invocation tool. If no callable invoke tool exists, Assignment Markdown is coordination text only; do **not** claim subagent dispatch.
+
+## Codex-only context
+
+- Plugin source: `.codex-plugin/plugin.json`.
+- Runtime skills: repo `skills/` mounted by the Codex plugin (`"skills": "./skills/"`).
+- `/pm`: shared force entry via the `pm` skill; after that, role behavior comes from `mstar-roles`.
+- Role files under `agents/` are for hosts that load agent shells; Codex role execution should load `mstar-roles` references directly.
+- Tool and plugin availability can be lazy-loaded or session-dependent. Use the tools actually present in the current session; do not infer capability from documentation alone.
+
+## Skill loading
+
+1. Read `mstar-harness-core`.
+2. Read `mstar-host` and this Codex reference.
+3. Load `mstar-roles` and the active role reference.
+4. Load topic skills on demand per the role reference.
+
+Use skill names in prompts and references. Avoid absolute local paths unless the user is maintaining this repository or the skill is not installed and must be read from the checkout.
+
+## Clarify
+
+- Codex does not imply an OpenCode-style `question` tool.
+- If a structured user-input tool is available in the active mode, use it for concise 1-3 choice decisions.
+- Otherwise ask one concise Markdown question only after codebase exploration cannot answer it.
+- `update_plan` / local todo UI is session progress only; it does not replace `{PLAN_DIR}` plans or `{HARNESS_DIR}/status.json`.
+
+## Dispatch and role execution
+
+- **No invoke tool = no dispatch**: printing `## Assignment` does not start another Codex worker.
+- If Codex exposes multi-agent tools, PM may dispatch through those tools and must follow `parallel-dispatch.md`.
+- If no invoke tool is present, use single-session role execution: state the active role, load that role reference, complete the assignment, and return Completion Report v2.
+- QC tri-review is only "parallel" when three distinct callable reviewer sessions are actually launched in one dispatch turn. Without that, run a clearly labeled serial/manual review path or return `Blocked` for PM rerouting.
+- Leaf executors still follow `mstar-dispatch-gates`: no recursive Task/subagent calls unless Assignment says `Delegation: allowed (...)`.
+
+## Files, shell, and approvals
+
+- Prefer `rg` / `rg --files` for search and `apply_patch` for manual edits.
+- Respect Codex sandbox and approval prompts. If a required command fails because of sandbox or network restrictions, request escalation through the host approval mechanism.
+- Do not edit global Codex plugin metadata, marketplace files, credentials, secrets, or user config without explicit user consent.
+- Browser, image, document, spreadsheet, presentation, and automation capabilities are host tools. Use them only when the user request or verification need calls for them.
+
+## Git and final evidence
+
+- Git work still follows `mstar-branch-worktree` and the Assignment `Working branch` / `Branch policy`.
+- Codex app git directives, when available, are audit annotations only. Emit them only after the underlying git action succeeds; never use a directive as a substitute for staging, committing, pushing, or PR creation evidence.
+- Completion reports should cite concrete commands, artifacts, and commit lines when required by the Assignment.
+
+## Gotchas
+
+- Codex plugin install gives skills, not automatic OpenCode-style named role invocations.
+- Tool discovery (`tool_search`) can reveal capabilities, but availability is not authorization; Assignment `Delegation` still controls use.
+- Session plans, chat summaries, and UI todos are not durable harness SSOT unless mirrored to `{HARNESS_DIR}`.

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

@@ -0,0 +1,175 @@
+# Cursor Plan Mode × Harness Dual-Write Bridge
+
+> **Load order**: Read **`mstar-harness-core`** first, then **`mstar-plan-conventions`** and **`mstar-plan-artifacts`** before the first **CreatePlan** in Plan mode. Path symbols `{HARNESS_DIR}`, `{PLAN_DIR}`, `{SPECS_DIR}` are defined in `mstar-plan-conventions`. On conflict, **`mstar-harness-core`** wins.
+
+## Purpose
+
+Cursor **Plan mode** uses **CreatePlan** and built-in plan todos for session UX. Morning Star **SSOT** lives on disk under **`{HARNESS_DIR}`** (default `.agents/`). This reference defines **dual-write**: mirror every durable plan artifact to the repo; never treat the Cursor plan URI alone as the handoff surface.
+
+## Priority (hard)
+
+1. User explicit instructions (this turn)
+2. Project `AGENTS.md` / `CLAUDE.md`
+3. **`{HARNESS_DIR}` / `{PLAN_DIR}` / `status.json`** (harness SSOT)
+4. Cursor CreatePlan body and plan todos (session UX mirror)
+
+**NEVER** cite only a Cursor plan file path in Assignment **Plan Path**, **Context Loaded**, or Completion Report when `{PLAN_DIR}/<plan-id>-<name>.md` should exist.
+
+## When this applies
+
+- Cursor **Plan mode** is active (system guidance to use **CreatePlan** / **SwitchMode**).
+- Morning Star plugin or `/pm` is in use (`mstar-host`, `pm` skill, or `rules/mstar-cursor-plan-mode.mdc`).
+
+## Before the first CreatePlan
+
+1. **Read** (minimum): `mstar-plan-conventions`, `mstar-plan-artifacts` (SKILL.md); Prepare gates from `mstar-phase-gates` if not hotfix.
+2. **Discover** `{HARNESS_DIR}` / `{PLAN_DIR}` per `mstar-plan-conventions` (prefer `.agents/` + `.agents/plans/`).
+3. **Initialize** if absent (see checklist below).
+
+### Harness initialization checklist
+
+When plan management is required and directories are missing:
+
+1. Create `{HARNESS_DIR}` and `{PLAN_DIR}`.
+2. Create `{PLAN_DIR}/reports/`.
+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`.
+
+Reuse legacy `.plans/` or `plans/` only when already present; do not duplicate structures.
+
+Full PM checklist: `mstar-roles/references/project-manager/plan-management.md`.
+
+## CreatePlan: fixed bootstrap todos (prefix)
+
+**Emit these three todos first**, in order, **before** any implement / code todos. Do **not** mark implement todos in progress until all three are **done**.
+
+| Todo ID (use in title) | Goal | On-disk outcome |
+|------------------------|------|-----------------|
+| **`harness-init`** | Bootstrap harness tree | `{HARNESS_DIR}/`, `{PLAN_DIR}/`, `reports/`, `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 |
+
+### `spec-register` minimum fields
+
+Add one object to `status.json` → `plans[]`:
+
+```json
+{
+  "id": "<plan-id>",
+  "status": "Todo",
+  "file": ".agents/plans/<plan-id>-<short-name>.md",
+  "metadata": {
+    "primary_spec": "<spec-id or path if known>",
+    "description": "<one-line summary>"
+  }
+}
+```
+
+Set `updated_at` on `status.json` to today (`YYYY-MM-DD`). Commit harness files in the **business repo** when the project tracks `.agents/` (default).
+
+### `mirror-plan` minimum content
+
+- YAML or markdown frontmatter with `plan_id`, title, status (`Todo` / `InProgress` — not `Done` unless PM/QA authority).
+- **Task list** as markdown checkboxes (`- [ ]` / `- [x]`) matching CreatePlan implement todos.
+- Link: “SSOT status: `{HARNESS_DIR}/status.json` → `plans[]` / `residual_findings`.”
+
+After **CreatePlan**, keep CreatePlan body and mirror file **in sync** when scope changes (update both in the same coordination round).
+
+## CreatePlan body template (copyable)
+
+Use this structure in CreatePlan `plan` markdown; mirror the same sections into `{PLAN_DIR}/<plan-id>-<name>.md`.
+
+```markdown
+# Plan: <title>
+
+**plan_id**: <plan-id>
+**HARNESS_DIR**: .agents/
+**Plan file (SSOT)**: .agents/plans/<plan-id>-<short-name>.md
+**status.json**: .agents/status.json
+
+## Prepare gates
+
+- specify: [done|n/a]
+- clarify: [done|n/a]
+- plan: [done|in progress]
+
+## Tasks (mirror as checkboxes in SSOT plan file)
+
+### Bootstrap (fixed prefix — complete before implement)
+
+1. harness-init — init .agents/, status.json, reports/, archived/residuals/
+2. spec-register — register plan_id in status.json; spec stub if applicable
+3. mirror-plan — write .agents/plans/<plan-id>-<short-name>.md
+
+### Implement
+
+- [ ] <task-id-1>: <description>
+  - Done when: git commit on Working branch + checkbox [x] in SSOT plan + evidence below
+- [ ] <task-id-2>: ...
+
+## Working branch
+
+<branch-name or "PM to assign before implement">
+
+## Verification
+
+- Commands / tests required before InReview
+```
+
+## Implement todo completion gate (every code todo)
+
+Embed this checklist **inside each implement todo description** in CreatePlan (and mirror the same text on the matching checkbox line in the SSOT plan file).
+
+**Before marking the todo done:**
+
+1. **Commit**: `git add` + `git commit` on the authorized **Working branch** for this **task id** (one commit per task unless PM explicitly allowed batched commits in Assignment).
+2. **Plan checkbox**: Set `- [x]` on the matching line in `{PLAN_DIR}/<plan-id>-<name>.md`.
+3. **status.json** (when PM round requires): bump `plans[].status` (e.g. `InProgress`) or append coordination notes per `mstar-plan-artifacts`.
+4. **Evidence**: Record real `git log -1 --oneline` in Completion Report v2 **Git** (or Plan-mode status note if executing as PM in Plan mode).
+
+**NEVER**
+
+- Mark implement todos done without a commit when tracked files changed.
+- Batch all work into one closing commit unless PM documented an exception.
+- Mark plan-level `Done` in `status.json` without PM/QA authority.
+
+Dev-role NEVER rules also apply when executing as implementer: `mstar-roles/references/fullstack-dev-shared.md` (Git NEVER).
+
+## SwitchMode → Agent (pre-flight)
+
+Before switching from Plan to Agent for implementation (or declaring Plan phase complete):
+
+- [ ] `{PLAN_DIR}/<plan-id>-<name>.md` exists on disk
+- [ ] `status.json` contains `plans[]` entry with matching `id` and `file`
+- [ ] Bootstrap todos `harness-init`, `spec-register`, `mirror-plan` are **done**
+- [ ] CreatePlan implement todos reference **task ids** traceable to SSOT plan checkboxes
+- [ ] **Plan Path** for any Assignment uses the SSOT path, not the Cursor plan URI
+
+If any item fails → **Blocked**; finish harness sync before implement.
+
+## PM in Plan mode (`/pm`)
+
+When `/pm` runs under Plan mode:
+
+- Load this reference via **`mstar-host`** (Cursor detection) after `mstar-harness-core`.
+- **CreatePlan** todos **must** include the three bootstrap prefix items.
+- Prepare phase (`specify → clarify → plan`) still applies; `mirror-plan` is the harness **`plan`** artifact, not a substitute for clarify.
+- Before QC dispatch, read **`mstar-review-qc`** (unchanged).
+
+## Anti-patterns
+
+| Anti-pattern | Fix |
+|--------------|-----|
+| CreatePlan only, no `.agents/` files | Run bootstrap todos; Write mirror plan + status.json |
+| Todo done, no commit | Commit per task; paste `git log -1` evidence |
+| Drift between CreatePlan and SSOT plan | Update both in same round |
+| Cursor plan URI as Plan Path | Use `{PLAN_DIR}/...` path |
+| Skip `spec-register` | Add `plans[]` row before implement |
+
+## Related skills
+
+- `mstar-plan-conventions` — discovery, init, `writing-plans` path gate
+- `mstar-plan-artifacts` — `status.json`, reports, 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

@@ -0,0 +1,73 @@
+# Cursor host reference
+
+Load when **`mstar-host`** detection resolves **cursor** (CreatePlan / SwitchMode, Task + `subagent_type`, or Cursor `/pm` flow).
+
+Parallel PM dispatch: **`parallel-dispatch.md`** (Task tool uses same turn model).
+
+## Cursor-only context
+
+- Role prompts: `mstar-roles`; **`/pm`** → `project-manager` via `pm` skill + `mstar-roles`.
+- Routing-eval: `.cursor/skills/mstar-routing-eval/` — maint only.
+
+## Plan mode × harness dual-write
+
+When **Plan mode** is active, **CreatePlan is session UX**; SSOT is **`{HARNESS_DIR}`** (default `.agents/`) — `{PLAN_DIR}/<plan-id>-<name>.md`, `{HARNESS_DIR}/status.json`.
+
+Before first **CreatePlan**: Read `mstar-plan-conventions`, `mstar-plan-artifacts`, Prepare gates from `mstar-phase-gates` when not hotfix. Full procedure: **`cursor-plan-mode-bridge.md`**.
+
+**Bootstrap CreatePlan todos (prefix, before implement):**
+
+| Todo ID | Purpose |
+|---------|---------|
+| `harness-init` | Init `{HARNESS_DIR}`, `{PLAN_DIR}`, `reports/`, `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}/` |
+
+Each **implement todo**: per–task-ID **git commit** on Working branch → SSOT `- [x]` → optional `status.json` sync → `git log -1 --oneline` evidence.
+
+Before **SwitchMode → Agent**: mirror plan exists; `status.json` lists `plan_id`; bootstrap todos done. **Never** use only the Cursor plan URI as **Plan Path**.
+
+Enforcement: `rules/mstar-cursor-plan-mode.mdc` when plugin active.
+
+## `/pm` precedence
+
+1. User explicit instructions
+2. Project `AGENTS.md` / `CLAUDE.md`
+3. `mstar-harness-core` and `mstar-*` skills
+4. `mstar-host` + this reference
+
+## Task tool (QC tri-review)
+
+- Apply **`parallel-dispatch.md`**: prerequisite message may prep only; dispatch message emits **all `N`** Tasks (**3** for tri-review) in **one** message when parallel is required.
+- `subagent_type`: `qc-specialist`, `qc-specialist-2`, `qc-specialist-3`.
+- Identical across three Tasks: **`plan_id`**, **`Review cwd`**, **`Review range` / Diff basis** (`mstar-branch-worktree`, `mstar-dispatch-gates`, `mstar-review-qc`).
+- Parallel QC ≠ different review cwd per reviewer; one integrated HEAD for scope.
+- Status Update may note QC ran via parallel Task subagents.
+
+## Supplemental execution modes
+
+**Mode A — Single session, multiple roles:** PM writes Assignment; executor states `Acting as role: …` and loads `mstar-roles` reference. QC/QA without Task: same field alignment rules.
+
+**Mode B — Multi-window:** One Assignment per chat; first turn loads role via `mstar-roles`; PM consolidates in main thread.
+
+**Mode C — Worktrees:** `mstar-branch-worktree` + `mstar-dispatch-gates` for concurrent writers; do not assign different tri-review cwd by default.
+
+**No recursive Task in implement subagents:** Task recipient is already `Execute as`; must not re-spawn same dev role. Assignment wins over conflicting outer messages (`Delegation: forbidden`).
+
+## Clarify
+
+- No `question` tool: structured Markdown or Cursor UI.
+- “Question asked” ≠ clarify done; high-impact ambiguity → `Blocked` or escalation.
+
+## Superpowers
+
+If no Skill invocation tool: `mstar-superpowers-align` “plugin not installed”; **Read** upstream `SKILL.md` before execution.
+
+## Gotchas
+
+- Tri-review needs identical `plan_id` and review scope fields.
+- Task parallelism does not relax branch/worktree isolation.
+
+## Project rules
+
+Project `AGENTS.md` / `CLAUDE.md` upward from cwd override global harness defaults when they conflict with Cursor-side rules; user instructions win.

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

@@ -0,0 +1,58 @@
+# OpenCode host reference
+
+Load when **`mstar-host`** detection resolves **opencode** (`question` tool, `@<agent-id>` invoke, or OpenCode session).
+
+Parallel PM dispatch: **`parallel-dispatch.md`** (read in dispatch rounds).
+
+## Role loading
+
+- **Role shell**: `agents/<id>.md` referenced by `opencode.json` `agent.<id>` (frontmatter + role binding only).
+- **Role body**: `mstar-roles` `references/<id>.md` (or shared references + parameters).
+- Superpowers conflicts: `mstar-superpowers-align`.
+
+## OpenCode-specific capabilities
+
+- **Structured clarify**: prefer `question` tool (title, prompt, options, optional custom text). Requires `permission.question` in config (user-maintained; do not edit global config without consent).
+- **Built-in subagents**: `@explore` (read-only), `@general`; subject to `mstar-harness-core` explore boundaries.
+- **Named roles (`@<agent-id>`)**: configured in `opencode.json` `agent.<id>` must be **actually invoked** by PM. Assignment Markdown alone does not open sessions.
+- **Per-role models**: configurable per subagent in `opencode.json`.
+
+## Invoke entry
+
+Use host subagent / Task / equivalent per **`parallel-dispatch.md`**. OpenCode PM typically uses **`@<agent-id>`** or the host’s subagent entry — same **no tool = no dispatch** rule.
+
+## Prepare phase — serial roles still require invoke
+
+`mstar-roles` **project-manager** may route `@explore → @product-manager → @architect` **sequentially**. Each handoff still needs a real **host invoke** with Assignment (often **`N = 1`** per dispatch turn). Writing PRD / architecture only in the PM chat when routing assigns **`product-manager`** or **`architect`** is **not** a substitute. Cross-check: `mstar-roles` → `references/project-manager.md` → **§1.1.1a Phase routing pre-flight**.
+
+## Gotchas
+
+- `question` availability is config-dependent; if unavailable, structured Markdown clarify.
+- `@explore` is orientation only, not role-owned implementation or review deliverables.
+- More MCPs do not replace phase gates or evidence rules.
+
+## Session noise control
+
+- Large unrelated platform injections (e.g. long ecosystem prompts): prefer on-demand / `alwaysApply: false` when not stack-relevant.
+- One default channel per capability class (search, docs).
+
+## Optional MCPs / skills (user-enabled)
+
+Aligned with `mstar-harness-core` `references/open-harness-principles.md`. Editing global `opencode.json` requires explicit user consent.
+
+| Capability | Purpose | Notes |
+|------|------|------|
+| **Current docs** | Versioned API/libs | Context7-like MCP or equivalent |
+| **Web search** | Time-sensitive / migrations | Avoid duplicate search MCPs |
+| **Code pattern search** | Cross-repo references | e.g. grep.app MCP |
+| **Repo graph** | Impact / PR risk | e.g. GitNexus |
+| **Browser / E2E** | Observable QA evidence | agent-browser, Playwright |
+| **Git workflow** | Atomic commits, branch closure | git-commit, finishing-a-development-branch |
+| **Systematic debugging** | RCA before fix | `mstar-superpowers-align` |
+| **OpenViking memory** | Long-term memory tools | Only if `memsearch` present; `openviking-memory-plugin.md` |
+
+**Not recommended**: overlapping search MCPs; extra tools to mask missing harness baseline.
+
+## Maintenance boundary
+
+Runtime only — do not modify `opencode.json`, `secrets.env`, or `.secrets/*` without explicit user consent.

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

@@ -0,0 +1,42 @@
+# Parallel dispatch (invoke-capable hosts)
+
+Shared PM dispatch contract for **any** host that uses subagent / Task / named-role invoke (OpenCode, Cursor Task, Codex only when a callable multi-agent / Task tool is actually available). Process SSOT also in `mstar-dispatch-gates`.
+
+If the active host has no callable invoke tool, this reference does not create delegation capability: use single-session execution, multi-window handoff, or mark dispatch `Blocked`.
+
+## Paste-only failure
+
+Printing `## Assignment` in the main thread **without** matching host invocations is **not** delegation; downstream work **does not start**. Parallel dispatch makes this worse (N Assignments printed, zero invokes).
+
+## Prerequisite vs dispatch turn
+
+- **Prerequisite turn** (optional): `bash` / `read` / `glob` / `grep` to collect facts (`merge-base`, `Review range`, `git rev-parse`, paths). **Do not** emit **any** batch dispatch in this message unless `N = 1` and that single call *is* the dispatch.
+- **Dispatch turn** (when `N ≥ 2`): the **first** message that emits **any** dispatch for the batch must contain **all `N`** invocations. If not ready for all `N`, emit **zero** dispatches — finish prep, then one message with **`N`** calls.
+
+## Mandatory order (dispatch turn)
+
+1. Finalize all `N` Assignment payloads (after any prerequisite turn).
+2. Count distinct `Execute as` sessions (`N`).
+3. Issue **`N` host invocations first** (subagent / Task / `@agent-id`), each with one Assignment body. For parallel work, **all `N` tool calls in one assistant message** when the host allows.
+4. Optionally post a short **Status Update** after invocations (audit trail only — does not replace step 3).
+
+## Hard rules
+
+- **Emit zero until batch-ready**: if `N ≥ 2` and only one invoke is possible now, **do not** send that one; complete payloads, then **`N` in one message**.
+- Do not end the dispatch turn until **`N` invocations emitted**, or mark `Blocked` / `dispatch incomplete`.
+- Dual-track implement: **`N = 2` ⇒ two invocations in one message** when parallel is required.
+- Status Update on dispatch turns: **`Subagent invokes issued: N`** (must match Assignment count). If Assignments were written but `N = 0` → **`dispatch failed — paste-only`**; fix next message.
+
+## QC tri-review
+
+- Launch `qc-specialist`, `qc-specialist-2`, `qc-specialist-3` in **one** dispatch turn (**3** invocations, one message).
+- Do not claim parallel QC unless all three were issued in that turn.
+- Post-dispatch: verify three distinct agent IDs and intended model mapping; on mismatch → invalid dispatch, re-dispatch before consolidation.
+
+## Self-check before send
+
+1. Required assignments this turn? (`N`)
+2. Prerequisite-only message? → **zero** batch dispatches unless `N = 1`.
+3. Dispatch message contains **exactly `N`** invocation calls?
+4. QC tri-review → **exactly 3** in one dispatch message?
+5. Previous message was prerequisite-only → this message must include **all `N`** (not “QC1 first”).

package/harness-skills/mstar-plan-artifacts/SKILL.md

@@ -3,29 +3,30 @@ name: mstar-plan-artifacts
 description: Morning Star plan harness artifacts — `{PLAN_DIR}` main plans and `reports/`, `{KNOWLEDGE_DIR}` / `{ITERATION_DIR}` indexes, Done compaction, plus `{HARNESS_DIR}/status.json` and root `residual_findings` (severity SSOT, open/archived lifecycle, `notes.json`). Read when writing plans or QC reports, maintaining knowledge/iteration indexes, reading or writing `status.json` / R#, Done compaction, or mapping QC severity to JSON. Required for `@project-manager` on status, residuals, and InReview/QC waves; `@qc-specialist*` before `reports/**/*.md`; `@qa-engineer` before closing R#. Verdict rules in `mstar-review-qc`; paths in `mstar-plan-conventions`.
 ---
 
-## Load order（必读顺序）
+## Load order
 
-**首次 Read 本 skill 前：必须先 Read `mstar-harness-core`（SKILL.md），并按需 Read `mstar-plan-conventions`（路径符号）。** 涉及 Git 分支 / worktree / QC 检出 → **`mstar-branch-worktree`**。冲突时 **以 `mstar-harness-core` 为准**。
+**Before first Read of this skill: Read `mstar-harness-core` (SKILL.md), and `mstar-plan-conventions` when path symbols matter.** Git branch / worktree / QC checkout → **`mstar-branch-worktree`**. On conflict, **`mstar-harness-core` wins**.
 
-## Scope（plan 目录工件）
+## Scope (plan directory artifacts)
 
-| Topic | 详见 |
-|-------|------|
-| 主 plan、reports 命名、QC 波次、residual 与 plan 索引顺序 | `references/plan-files-and-reports.md` |
-| knowledge / iterations / specs 边界与索引 | `references/knowledge-and-designs.md` |
-| Done 行瘦身 Profile A/B | `references/done-compaction.md` |
-| `status.json`、residual severity、生命周期、`jq` | `references/status-and-residuals.md` |
-| 空仓库 `status.json` / `notes.json` 模板 | `templates/status.empty.json`、`templates/notes.empty.json`（见 `templates/README.md`） |
+| Topic | See |
+|-------|-----|
+| Main plan, reports naming, QC waves, residual and plan index order | `references/plan-files-and-reports.md` |
+| knowledge / iterations / specs boundaries and indexes | `references/knowledge-and-designs.md` |
+| Done row compaction Profile A/B | `references/done-compaction.md` |
+| `status.json`, residual severity, lifecycle, `jq` | `references/status-and-residuals.md` |
+| Empty-repo `status.json` / `notes.json` templates | `templates/status.empty.json`, `templates/notes.empty.json` (`templates/README.md`) |
+| Tech-debt rollup (read-only) | `scripts/tech-debt-rollup.sh` |
 
-**Out of scope:** 分支与 QC/QA 检出对齐 → **`mstar-branch-worktree`**；QC 清单与 verdict → **`mstar-review-qc`**；`{HARNESS_DIR}` 路径发现与目录初始化步骤 → **`mstar-plan-conventions`**。
+**Out of scope:** branch and QC/QA checkout alignment → **`mstar-branch-worktree`**; QC checklist and verdict → **`mstar-review-qc`**; `{HARNESS_DIR}` discovery and init → **`mstar-plan-conventions`**.
 
-## `status.json` 与 open residual（摘要）
+## `status.json` and open residual (summary)
 
-- **`{HARNESS_DIR}/status.json`**：`plans[]` 行状态 + 根级 **`residual_findings[<plan-id>]`**（open 列表 **SSOT**）。
-- **Canonical**：新登记只写根级 `residual_findings`；**`metadata.residual_findings`** 仅 legacy 读，**禁止**双写。
-- **生命周期**：open → 验证关闭 → **`archived/residuals/<plan-id>.json`**；**`severity`** 机器枚举见 reference。
-- **`notes.json`**、**`tech_debt_summary`**（可选聚合视图）。
+- **`{HARNESS_DIR}/status.json`**: `plans[]` row status + root **`residual_findings[<plan-id>]`** (open list **SSOT**).
+- **Canonical**: register new findings only at root `residual_findings`; **`metadata.residual_findings`** is legacy read-only — **do not** dual-write.
+- **Lifecycle**: open → verified close → **`archived/residuals/<plan-id>.json`**; machine **`severity`** enum in reference.
+- **`notes.json`**, optional **`tech_debt_summary`** (rollup view; compute via **`scripts/tech-debt-rollup.sh`**).
 
-字段、severity 映射表、归档与 `jq` 示例 → **`references/status-and-residuals.md`**。
+Field semantics, severity mapping, archive flow, and `jq` examples → **`references/status-and-residuals.md`**.
 
-**Templates（本 skill）：** `templates/status.empty.json`、`templates/notes.empty.json` — 复制到 `{HARNESS_DIR}/`（说明见 `templates/README.md`）。
+**Templates (this skill):** `templates/status.empty.json`, `templates/notes.empty.json` — copy into `{HARNESS_DIR}/` (`templates/README.md`).