@mstar-harness/opencode 3.2.5 → 3.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (24) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/dist/mstar.js +1329 -1271
  3. package/harness-skills/mstar-audit/SKILL.md +3 -2
  4. package/harness-skills/mstar-audit/references/audit-playbook.md +19 -1
  5. package/harness-skills/mstar-audit/references/codebase-audit.md +19 -3
  6. package/harness-skills/mstar-audit/references/finding-format.md +5 -1
  7. package/harness-skills/mstar-audit/references/pr-review.md +78 -9
  8. package/harness-skills/mstar-audit/references/security-review.md +221 -0
  9. package/harness-skills/mstar-conventions/SKILL.md +4 -2
  10. package/harness-skills/mstar-conventions/references/harness-bootstrap-and-agents-layering.md +5 -1
  11. package/harness-skills/mstar-harness-core/SKILL.md +1 -1
  12. package/harness-skills/mstar-roles/SKILL.md +17 -13
  13. package/harness-skills/mstar-roles/references/architect.md +9 -11
  14. package/harness-skills/mstar-roles/references/code-reviewer.md +12 -15
  15. package/harness-skills/mstar-roles/references/frontend-dev.md +9 -11
  16. package/harness-skills/mstar-roles/references/fullstack-dev-shared.md +9 -11
  17. package/harness-skills/mstar-roles/references/ops-engineer.md +9 -11
  18. package/harness-skills/mstar-roles/references/product-manager.md +9 -11
  19. package/harness-skills/mstar-roles/references/project-manager/dispatch-and-assignment.md +2 -0
  20. package/harness-skills/mstar-roles/references/prompt-engineer.md +10 -13
  21. package/harness-skills/mstar-roles/references/qa-engineer.md +8 -12
  22. package/harness-skills/mstar-roles/references/qc-specialist-shared.md +10 -17
  23. package/harness-skills/mstar-roles/references/writing-specialist.md +8 -9
  24. package/package.json +1 -1
@@ -105,7 +105,7 @@ PM 在 Assignment 写 **`Task category`**(主类 + 可选 `secondary`):
105
105
  | `mstar-compound-refresh` | 知识维护 —— 审查/更新/合并/删除 `{KNOWLEDGE_DIR}` 文档;**项目知识 bootstrap**(无/残旧 STRATEGY.md、CONCEPTS.md、`{KNOWLEDGE_DIR}`)→ `references/project-knowledge-bootstrap.md` |
106
106
  | `mstar-strategy` | `STRATEGY.md` 全局战略方向 —— 产品愿景、技术方向、决策原则 |
107
107
  | `mstar-skill-authoring` | 通用 skill 撰写门控(SkillsBench 六原则):trigger 契约、紧凑 5 问 body、渐进披露、paired 证据 |
108
- | `mstar-audit` | Variant carrier:common core(hard rules、recon、vet、variant dispatch)+ SKILL.md `## Plan output (all variants)`(Status block、plan files、handoff)+ `references/codebase-audit.md`(full-audit 变体:9 类别 fan-out、effort、scope variants、Phase 4 excerpt/reconcile、audit index 模板)+ `references/pr-review.md`(`pr` 变体);`audit-playbook` + `finding-format` + `plan-quality-bar` |
108
+ | `mstar-audit` | Variant carrier:common core(hard rules、recon、vet、variant dispatch)+ SKILL.md `## Plan output (all variants)`(Status block、plan files、handoff)+ `references/codebase-audit.md`(full-audit 变体:9 类别 fan-out、effort、scope variants、Phase 4 excerpt/reconcile、audit index 模板)+ `references/security-review.md`(security 深查:exploitability 门槛、FP 纪律、LLM/供应链面)+ `references/pr-review.md`(`pr` 变体);`audit-playbook` + `finding-format` + `plan-quality-bar` |
109
109
  | `mstar-roles` | 角色正文 hub |
110
110
  | `mstar-host` | 宿主适配(自动识别;`references/opencode.md` / `cursor.md` / `codex.md` / `kimi.md` / `parallel-dispatch.md`) |
111
111
 
@@ -1,19 +1,20 @@
1
1
  ---
2
2
  name: mstar-roles
3
- description: Morning Star role prompt hub — `agents/*.md` shells plus full behavior in `references/*.md`, each with a **Required Skill Dependencies** list (which `mstar-*` topic skills to load after `mstar-harness-core`). Always load for any Morning Star role (`project-manager`, `product-manager`, `architect`, `code-reviewer`, `fullstack-dev`, `fullstack-dev-2`, `frontend-dev`, `qa-engineer`, `qc-specialist*`, `ops-engineer`, `writing-specialist`, `prompt-engineer`). Cross-role **Role → typical topic skills** summary in this SKILL.md; per-role lists in `references/*.md` are authoritative for that role's session. Full topic skill index → **`mstar-harness-core`**.
3
+ description: Morning Star role prompt hub — `agents/*.md` shells plus full behavior in `references/*.md`. Role files are **identity-first** (mission / responsibilities / NEVER rules); topic `mstar-*` skills appear only as **PM-activated skill presets** (Assignment `Skill presets:` field), not default dependencies. Always load for any Morning Star role (`project-manager`, `product-manager`, `architect`, `code-reviewer`, `fullstack-dev`, `fullstack-dev-2`, `frontend-dev`, `qa-engineer`, `qc-specialist*`, `ops-engineer`, `writing-specialist`, `prompt-engineer`). Cross-role **Role → skill presets** summary in this SKILL.md; per-role preset menus in `references/*.md` are authoritative once PM activates them. Full topic skill index → **`mstar-harness-core`**.
4
4
  ---
5
5
 
6
- ## Load Order (Required)
6
+ ## Load Order
7
7
 
8
8
  When a Morning Star role starts work in a session:
9
9
 
10
- 1. Read `mstar-harness-core` first (SKILL.md), then **only** the topic `mstar-*` skills required for this role/task (see matrix below — do not read all topic skills by default).
11
- 2. Read this `mstar-roles` skill.
12
- 3. Resolve role mapping and parameter table below.
13
- 4. Read the corresponding `references/<role>.md` file each role file lists **Required Skill Dependencies** for that role (canonical per-role load list).
14
- 5. Expand placeholders from role parameters before execution.
10
+ 1. Read this `mstar-roles` skill; resolve role mapping and parameter tables below.
11
+ 2. Read the corresponding `references/<role>.md` file — **identity-first**: mission, scope, and NEVER rules come before any skill list.
12
+ 3. Load topic skills per the Assignment **`Skill presets:`** field, following that role's **Skill Preset (PM-Activated)** section. Omitted on an implementation / QC / QA round ⇒ the role's `standard` preset applies by default; explicit `Skill presets: none` (or a trivial route) ⇒ execute from identity + assignment alone without topic skills. Whenever `mstar-harness-core` is loaded, it remains the global entry (state machine, gates, routing).
13
+ 4. Expand placeholders from role parameters before execution.
15
14
 
16
- If any conflict appears, `mstar-harness-core` remains the authoritative source for lifecycle, gates, routing, and invariants. The table below is the cross-role summary; when a role file lists different **on-demand** skills, follow the role file for that session.
15
+ If any conflict appears, `mstar-harness-core` remains the authoritative source for lifecycle, gates, routing, and invariants. The table below summarizes each role's preset menu; when a role file's preset section differs, follow the role file for that session.
16
+
17
+ Exception: `project-manager` is the core orchestrator and keeps **required reading** (not a preset) — see `references/project-manager.md`.
17
18
 
18
19
  ## Role Reference Mapping
19
20
 
@@ -34,14 +35,16 @@ If any conflict appears, `mstar-harness-core` remains the authoritative source f
34
35
  | `writing-specialist` | `references/writing-specialist.md` | — |
35
36
  | `prompt-engineer` | `references/prompt-engineer.md` | — |
36
37
 
37
- ### Role → typical topic skills (after `mstar-harness-core`)
38
+ ### Role → skill presets (PM-activated)
39
+
40
+ PM-owned activation with a safe default: omitted `Skill presets:` on an implementation / QC / QA round means `standard`; explicit `none` runs identity-only. Rows summarize each role's preset menu — role-owned files (e.g. `references/qc-specialist/`, `references/qa-engineer/acceptance-gate.md`) are excluded; they always load with the reference.
38
41
 
39
- | Role | Typical adds |
42
+ | Role | Preset menu |
40
43
  | --- | --- |
41
44
  | `project-manager` | `mstar-dispatch-gates`, `mstar-phase-gates`, `mstar-conventions`, `mstar-roles` ref; + `references/project-manager/qa-trigger-matrix.md` for QA gate tiers; + `mstar-review-qc` before QC; + `mstar-branch-worktree` / `mstar-artifacts` as the round requires; + `mstar-skill-authoring` for skill work; + `mstar-iteration` for iteration lifecycle (start/drive/close); + `mstar-strategy` for strategic alignment; + `mstar-compound` / `mstar-compound-refresh` pre-loaded by `mstar-iteration` § iteration-close |
42
45
  | `fullstack-dev*`, `frontend-dev` | `mstar-coding-behavior`, `mstar-dispatch-gates`, `mstar-branch-worktree` (if repo writes); plan path symbols from `mstar-conventions` (minimal); `mstar-design-md` when implementing styled UI |
43
- | `qc-specialist*` | `mstar-branch-worktree`, `mstar-artifacts` (review bundle paths); `references/qc-specialist/` (workflow, checklist, template, lenses); `mstar-design-md` when reviewing UI |
44
- | `qa-engineer` | `mstar-branch-worktree`, `mstar-artifacts` (closing R#); `references/qa-engineer/acceptance-gate.md`; `mstar-design-md` when verifying visual output |
46
+ | `qc-specialist*` | Presets: `mstar-branch-worktree`, `mstar-artifacts` (review bundle paths); `mstar-design-md` when reviewing UI. Role-owned (never gated): `references/qc-specialist/` workflow/checklist/template (+ lenses on demand) |
47
+ | `qa-engineer` | Presets: `mstar-branch-worktree`, `mstar-artifacts` (closing R#); `mstar-design-md` when verifying visual output. Role-owned (never gated): `references/qa-engineer/acceptance-gate.md` |
45
48
  | `architect`, `product-manager` | `mstar-phase-gates` (Prepare), `mstar-artifacts` (knowledge/specs); `mstar-design-md` (creator + design intent); `mstar-strategy` (STRATEGY.md creation/maintenance) |
46
49
  | `code-reviewer` | `mstar-sdd` (per-task review mode); `mstar-audit` (audit mode: full workflow); `mstar-conventions` (paths); `mstar-artifacts` (plan-quality-bar for audit plans) |
47
50
  | `ops-engineer` | `mstar-coding-behavior`, `mstar-branch-worktree` |
@@ -83,11 +86,12 @@ PM consolidated (tri mode): `{SDD_DIR}/review/qc-consolidated.md` (same folder;
83
86
  - Edit behavior in `references/*.md`.
84
87
  - Edit role family parameters in this file.
85
88
  - Keep shared-family roles (`fullstack-dev*`, `qc-specialist*`) on one shared reference file.
89
+ - Role references stay **identity-first**: mission / responsibilities / NEVER rules before any skill list; topic-skill loads live only in the **Skill Preset (PM-Activated)** section.
86
90
  - Add new roles by updating mapping, parameters (if needed), and adding corresponding `agents/*.md` shell.
87
91
 
88
92
  ## Workflow
89
93
 
90
- 加载顺序:Read `mstar-harness-core` → Read 本 skill(角色映射 + 参数表)→ 解析对应 `references/<role>.md` 展开角色参数(`role_id` / `track` / `reviewer_index` 等)→ 按该角色文件的 Required Skill Dependencies 追加加载 执行。映射 / 参数表与磁盘 `references/*.md` 布局不符时先修再继续。
94
+ 加载顺序:Read 本 skill(角色映射 + 参数表)→ 解析对应 `references/<role>.md`(身份优先:mission / NEVER / responsibilities 在前)→ 按 Assignment 的 `Skill presets:` 字段加载专题 skill:实质轮次(implementation / QC / QA)缺省即默认该角色的 `standard` 预设;显式 `none`(或 trivial 路由)则以身份 + Assignment 执行。映射 / 参数表与磁盘 `references/*.md` 布局不符时先修再继续。
91
95
 
92
96
  ## Evidence
93
97
 
@@ -1,14 +1,3 @@
1
- ## Required Skill Dependencies
2
-
3
- **Hub matrix:** `mstar-roles` SKILL.md.
4
-
5
- **Always:** `mstar-harness-core`, `mstar-dispatch-gates`, `mstar-phase-gates` (Prepare: specify/clarify/plan), `mstar-conventions` (`{PLAN_DIR}`, plan-writing path).
6
-
7
- **Typically:** `mstar-artifacts` (specs, **`{ITERATION_DIR}/<id>/` package**); `mstar-coding-behavior`. Boundaries → **`mstar-iteration/references/iteration-artifact-boundaries.md`**.
8
-
9
- **On demand:** `mstar-branch-worktree` (when committing architecture docs to the business repo); `mstar-design-md` (when the plan involves UI work / design tokens — read DESIGN.md for design specs).
10
-
11
- **Host:** `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`).
12
1
 
13
2
  ## Role Mission
14
3
 
@@ -102,6 +91,15 @@ Do not create your own branch strategy.
102
91
  ## Effort (agent-oriented)
103
92
  ```
104
93
 
94
+ ## Skill Preset (PM-Activated)
95
+
96
+ Topic skills below are **presets activated by PM**, not unconditional role dependencies — the identity, responsibilities, and NEVER rules above stand alone. Loading follows the Assignment **`Skill presets:`** field: omitted on an implementation / QC / QA round ⇒ the `standard` preset below applies by default; explicit `Skill presets: none` (or a trivial route) ⇒ work from identity + assignment and do not self-load topic skills. When active, load in order (**hub matrix:** `mstar-roles` SKILL.md):
97
+
98
+ 1. `mstar-harness-core` → `mstar-dispatch-gates` → `mstar-phase-gates` (Prepare: specify/clarify/plan) → `mstar-conventions` (`{PLAN_DIR}`, plan-writing path)
99
+ 2. Typically: `mstar-artifacts` (specs, **`{ITERATION_DIR}/<id>/` package**); `mstar-coding-behavior`. Boundaries → **`mstar-iteration/references/iteration-artifact-boundaries.md`**
100
+ 3. On demand: `mstar-branch-worktree` (committing architecture docs to the business repo); `mstar-design-md` (plan involves UI work / design tokens — read DESIGN.md for design specs)
101
+ 4. Host: `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`)
102
+
105
103
  ## Completion Report
106
104
 
107
105
  Template (`{role_id}` = `architect`) → **`references/_shared/leaf-executor-core.md`**「Completion Report」。
@@ -2,21 +2,6 @@
2
2
 
3
3
  Read-only review/assessment seat with three modes: **Mode A — SDD task reviewer (default, L2)**, **Mode B — audit executor (`Task category: audit`)**, and **Mode C — PR review (`pr` variant)**.
4
4
 
5
- ## Required Skill Dependencies
6
-
7
- **Hub matrix:** `mstar-roles` SKILL.md.
8
-
9
- **Always:** `mstar-harness-core` (mandatory entry), `mstar-dispatch-gates` (leaf anti-recursion).
10
-
11
- **By mode:**
12
-
13
- - Mode A (SDD task reviewer): `mstar-sdd` → `references/task-reviewer-prompt.md`, `references/file-handoffs.md`
14
- - Mode B (audit executor): `mstar-audit` SKILL.md (common core) + `references/codebase-audit.md` (full-audit variant detail)
15
- - Mode C (PR review): `mstar-audit` SKILL.md (common core) + `references/pr-review.md` (`pr` variant detail) + `mstar-branch-worktree` (worktree isolation)
16
-
17
- **Paths:** `mstar-conventions`; add `mstar-artifacts` (plan-quality-bar) when writing audit plans.
18
-
19
- **Host:** `mstar-host` (detect; active host reference).
20
5
 
21
6
  ## Role Mission
22
7
 
@@ -112,6 +97,18 @@ If any item below matches, **stop** and return `Blocked` to `project-manager` in
112
97
  - Preferred: read-only review reports (Mode A) and audit plans (Mode B) in the paths above
113
98
  - Do not own: implementation (L1), formal QC gates (L3), acceptance / re-run verification (L4)
114
99
 
100
+ ## Skill Preset (PM-Activated)
101
+
102
+ Topic skills below are **presets activated by PM**, not unconditional role dependencies — the identity, mode definitions, and NEVER rules above stand alone. Loading follows the Assignment **`Skill presets:`** field (the assigned **mode** selects the mode preset): omitted on an implementation / review round ⇒ the `standard` preset below applies by default; explicit `Skill presets: none` (or a trivial route) ⇒ work from identity + assignment and do not self-load topic skills. When active, load in order (**hub matrix:** `mstar-roles` SKILL.md):
103
+
104
+ 1. `mstar-harness-core` (mandatory entry) → `mstar-dispatch-gates` (leaf anti-recursion)
105
+ 2. By mode:
106
+ - Mode A (SDD task reviewer): `mstar-sdd` → `references/task-reviewer-prompt.md`, `references/file-handoffs.md`
107
+ - Mode B (audit executor): `mstar-audit` SKILL.md (common core) + `references/codebase-audit.md`
108
+ - Mode C (PR review): `mstar-audit` SKILL.md + `references/pr-review.md` + `mstar-branch-worktree` (worktree isolation)
109
+ 3. Paths: `mstar-conventions`; add `mstar-artifacts` (plan-quality-bar) when writing audit plans
110
+ 4. Host: `mstar-host` (detect; active host reference)
111
+
115
112
  ## Completion Report
116
113
 
117
114
  Template (`{role_id}` = `code-reviewer`) → **`references/_shared/leaf-executor-core.md`**「Completion Report」.
@@ -1,14 +1,3 @@
1
- ## Required Skill Dependencies
2
-
3
- **Hub matrix:** `mstar-roles` SKILL.md.
4
-
5
- **Always:** `mstar-harness-core`, `mstar-coding-behavior`, `mstar-dispatch-gates`.
6
-
7
- **Typically:** `mstar-conventions` (paths + spec metadata).
8
-
9
- **On demand:** `mstar-branch-worktree` (repo writes); `mstar-phase-gates` (Execute / hotfix when referenced in assignment); `mstar-design-md` (when implementing styled UI — read DESIGN.md for tokens before writing components).
10
-
11
- **Host:** `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`).
12
1
 
13
2
  ## Role Mission
14
3
 
@@ -62,6 +51,15 @@ If plan drift appears during implementation, request plan write-back before cont
62
51
  - Same-repo concurrent writes require worktree isolation
63
52
  - Do not self-decide branch pivots to default branch
64
53
 
54
+ ## Skill Preset (PM-Activated)
55
+
56
+ Topic skills below are **presets activated by PM**, not unconditional role dependencies — the identity, responsibilities, and NEVER rules above stand alone. Loading follows the Assignment **`Skill presets:`** field: omitted on an implementation / QC / QA round ⇒ the `standard` preset below applies by default; explicit `Skill presets: none` (or a trivial route) ⇒ work from identity + assignment and do not self-load topic skills. When active, load in order (**hub matrix:** `mstar-roles` SKILL.md):
57
+
58
+ 1. `mstar-harness-core` → `mstar-coding-behavior` → `mstar-dispatch-gates`
59
+ 2. Typically: `mstar-conventions` (paths + spec metadata)
60
+ 3. On demand: `mstar-branch-worktree` (repo writes); `mstar-phase-gates` (Execute / hotfix when referenced in assignment); `mstar-design-md` (styled UI — read DESIGN.md tokens before writing components)
61
+ 4. Host: `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`)
62
+
65
63
  ## Completion Report
66
64
 
67
65
  Template (`{role_id}` = `frontend-dev`) → **`references/_shared/leaf-executor-core.md`**「Completion Report」。
@@ -8,17 +8,6 @@ Behavior is shared; track identity is parameterized.
8
8
  - `{role_id}`: `fullstack-dev` or `fullstack-dev-2`
9
9
  - `{track}`: `primary` or `parallel_secondary`
10
10
 
11
- ## Required Skill Dependencies
12
-
13
- **Hub matrix:** `mstar-roles` SKILL.md.
14
-
15
- **Always:** `mstar-harness-core`, `mstar-coding-behavior`, `mstar-dispatch-gates` (leaf anti-recursion before any Task/subagent).
16
-
17
- **Typically:** `mstar-conventions` (path symbols + `metadata.primary_spec` / `spec_refs`).
18
-
19
- **On demand:** `mstar-branch-worktree` (repo writes, `Working branch`); `mstar-phase-gates` (Execute / hotfix sections when gate fields are in the assignment); `mstar-design-md` (when task includes UI implementation — read DESIGN.md for design tokens).
20
-
21
- **Host:** `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`).
22
11
 
23
12
  ## Role Mission
24
13
 
@@ -81,6 +70,15 @@ If plan drift appears, request plan update before continuing.
81
70
  3. Test implementation for assigned scope
82
71
  4. Self-verification and evidence generation
83
72
 
73
+ ## Skill Preset (PM-Activated)
74
+
75
+ Topic skills below are **presets activated by PM**, not unconditional role dependencies — the identity, responsibilities, and NEVER rules above stand alone. Loading follows the Assignment **`Skill presets:`** field: omitted on an implementation / QC / QA round ⇒ the `standard` preset below applies by default; explicit `Skill presets: none` (or a trivial route) ⇒ work from identity + assignment and do not self-load topic skills. When active, load in order (**hub matrix:** `mstar-roles` SKILL.md):
76
+
77
+ 1. `mstar-harness-core` → `mstar-coding-behavior` → `mstar-dispatch-gates` (leaf anti-recursion before any Task/subagent)
78
+ 2. Typically: `mstar-conventions` (path symbols + `metadata.primary_spec` / `spec_refs`)
79
+ 3. On demand: `mstar-branch-worktree` (repo writes, `Working branch`); `mstar-phase-gates` (Execute / hotfix sections when gate fields are in the assignment); `mstar-design-md` (task includes UI implementation — read DESIGN.md for design tokens)
80
+ 4. Host: `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`)
81
+
84
82
  ## Completion Report
85
83
 
86
84
  Template (fill `{role_id}` = `{role_id}`) → **`references/_shared/leaf-executor-core.md`**「Completion Report」。
@@ -1,14 +1,3 @@
1
- ## Required Skill Dependencies
2
-
3
- **Hub matrix:** `mstar-roles` SKILL.md.
4
-
5
- **Always:** `mstar-harness-core`, `mstar-coding-behavior`, `mstar-dispatch-gates`, `mstar-branch-worktree` (repo writes, production-touching branches).
6
-
7
- **Typically:** `mstar-conventions` (paths).
8
-
9
- **On demand:** `mstar-phase-gates` (hotfix compressed path when assignment says hotfix).
10
-
11
- **Host:** `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`).
12
1
 
13
2
  ## Role Mission
14
3
 
@@ -65,6 +54,15 @@ When assignment is marked `high-risk`:
65
54
  ## Monitoring Checks
66
55
  ```
67
56
 
57
+ ## Skill Preset (PM-Activated)
58
+
59
+ Topic skills below are **presets activated by PM**, not unconditional role dependencies — the identity, responsibilities, and NEVER rules above stand alone. Loading follows the Assignment **`Skill presets:`** field: omitted on an implementation / QC / QA round ⇒ the `standard` preset below applies by default; explicit `Skill presets: none` (or a trivial route) ⇒ work from identity + assignment and do not self-load topic skills. When active, load in order (**hub matrix:** `mstar-roles` SKILL.md):
60
+
61
+ 1. `mstar-harness-core` → `mstar-coding-behavior` → `mstar-dispatch-gates` → `mstar-branch-worktree` (repo writes, production-touching branches)
62
+ 2. Typically: `mstar-conventions` (paths)
63
+ 3. On demand: `mstar-phase-gates` (hotfix compressed path when assignment says hotfix)
64
+ 4. Host: `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`)
65
+
68
66
  ## Completion Report
69
67
 
70
68
  Template (`{role_id}` = `ops-engineer`) → **`references/_shared/leaf-executor-core.md`**「Completion Report」。
@@ -1,14 +1,3 @@
1
- ## Required Skill Dependencies
2
-
3
- **Hub matrix:** `mstar-roles` SKILL.md.
4
-
5
- **Always:** `mstar-harness-core`, `mstar-dispatch-gates`, `mstar-phase-gates` (Prepare / clarify), `mstar-conventions` (`{PLAN_DIR}`, plan-writing path).
6
-
7
- **Typically:** `mstar-artifacts` (specs, **`{ITERATION_DIR}/<id>/` package** — not knowledge @ start); `mstar-coding-behavior`. Boundaries → **`mstar-iteration/references/iteration-artifact-boundaries.md`**.
8
-
9
- **On demand:** `mstar-branch-worktree` (when committing product docs to the business repo); `mstar-design-md` (when the plan involves UI work / design tokens — read DESIGN.md for design specs).
10
-
11
- **Host:** `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`).
12
1
 
13
2
  ## Role Mission
14
3
 
@@ -95,6 +84,15 @@ If writing files to business repo, use only PM-assigned `Working branch` / `Bran
95
84
 
96
85
  - **NEVER** embed human calendar estimates (person-days, FTE, “waiting for review X days”) inside **Effort (agent-oriented)** fields; keep agent-only sizing per `mstar-conventions` `references/effort-estimation.md`.
97
86
 
87
+ ## Skill Preset (PM-Activated)
88
+
89
+ Topic skills below are **presets activated by PM**, not unconditional role dependencies — the identity, responsibilities, and NEVER rules above stand alone. Loading follows the Assignment **`Skill presets:`** field: omitted on an implementation / QC / QA round ⇒ the `standard` preset below applies by default; explicit `Skill presets: none` (or a trivial route) ⇒ work from identity + assignment and do not self-load topic skills. When active, load in order (**hub matrix:** `mstar-roles` SKILL.md):
90
+
91
+ 1. `mstar-harness-core` → `mstar-dispatch-gates` → `mstar-phase-gates` (Prepare / clarify) → `mstar-conventions` (`{PLAN_DIR}`, plan-writing path)
92
+ 2. Typically: `mstar-artifacts` (specs, **`{ITERATION_DIR}/<id>/` package** — not knowledge @ start); `mstar-coding-behavior`. Boundaries → **`mstar-iteration/references/iteration-artifact-boundaries.md`**
93
+ 3. On demand: `mstar-branch-worktree` (committing product docs to the business repo); `mstar-design-md` (plan involves UI work / design tokens — read DESIGN.md for design specs)
94
+ 4. Host: `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`)
95
+
98
96
  ## Completion Report
99
97
 
100
98
  Template (`{role_id}` = `product-manager`) → **`references/_shared/leaf-executor-core.md`**「Completion Report」。
@@ -10,6 +10,7 @@ The concise gate summary remains in `references/project-manager.md`.
10
10
  - In tool hosts (OpenCode / Cursor Task / Codex with callable multi-agent tools), Markdown-only Assignment is not dispatch.
11
11
  - For parallel batch with `N >= 2`, dispatch turn must emit all `N` invokes in one message when host supports it.
12
12
  - **Same-repo writable parallel tracks**: tool concurrency and worktree isolation are **separate gates**. Before implement invokes, complete **`mstar-branch-worktree`** → **`references/parallel-writable-pre-dispatch.md`**.
13
+ - **Skill preset activation is PM-owned**: topic skills are presets in each role's `Skill Preset (PM-Activated)` section (`mstar-roles/references/<role>.md`), not self-loaded defaults. Omitting the `Skill presets:` field applies its documented default (`standard` on implementation / QC / QA rounds); identity-only execution requires explicit `Skill presets: none`.
13
14
 
14
15
  ## Executor Anti-Recursion Rules
15
16
 
@@ -77,6 +78,7 @@ The **`**You are a leaf executor. You MUST NOT:**`** section (previously just pr
77
78
  **SDD implementer session**: fresh | sticky | N/A — **default `fresh`**; `sticky` reuses same implementer subagent across tasks (reviewers stay fresh). See `mstar-sdd/references/sticky-implementer-session.md`
78
79
  **SDD dir**: absolute `<control_worktree_path>/{HARNESS_DIR}/sdd/<plan-id>/` when L1 lease gate active | `{HARNESS_DIR}/sdd/<plan-id>/` when waived / single checkout | N/A
79
80
  **Model tier**: fast | standard | capable | N/A
81
+ **Skill presets**: `standard` | <explicit skill list> | none — activates the `Execute as` role's preset from its `Skill Preset (PM-Activated)` section; default `standard` for implementation / QC / QA rounds unless the route is trivial
80
82
  **QC mode**: full tri-review | single | N/A — **default `full tri-review` when `Execution mode: sdd`**; `single` only for `inline` / override
81
83
  **Review package path**: <branch-review diff file> | N/A
82
84
  **Who runs this turn (executor lock)**: only `Execute as` role for this message
@@ -1,16 +1,3 @@
1
- ## Required Skill Dependencies
2
-
3
- **Hub matrix:** `mstar-roles` SKILL.md.
4
-
5
- **Always:** `mstar-harness-core`, `mstar-dispatch-gates`.
6
-
7
- **When editing harness text:** read **all** topic skills you touch — at minimum `mstar-phase-gates`, `mstar-conventions`, `mstar-artifacts`, `mstar-branch-worktree`, `mstar-review-qc`, `mstar-coding-behavior`, plus host adapters — so prompts stay aligned with SSOT and do not re-duplicate rules.
8
-
9
- **When creating a new skill, making a major skill rewrite, or changing trigger descriptions:** MUST read `mstar-skill-authoring` before editing.
10
-
11
- **Typically:** `mstar-conventions` (path symbols in examples).
12
-
13
- **Host:** `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`).
14
1
 
15
2
  ## Role Mission
16
3
 
@@ -59,6 +46,16 @@ When creating a new skill, making a major skill rewrite, changing frontmatter `d
59
46
  - Redundancy removed before adding new constraints
60
47
  - At least one replayable scenario exists for regression check
61
48
 
49
+ ## Skill Preset (PM-Activated)
50
+
51
+ Topic skills below are **presets activated by PM**, not unconditional role dependencies — the identity, responsibilities, and NEVER rules above stand alone. Loading follows the Assignment **`Skill presets:`** field: omitted on an implementation / QC / QA round ⇒ the `standard` preset below applies by default; explicit `Skill presets: none` (or a trivial route) ⇒ work from identity + assignment and do not self-load topic skills. When active, load in order (**hub matrix:** `mstar-roles` SKILL.md):
52
+
53
+ 1. `mstar-harness-core` → `mstar-dispatch-gates`
54
+ 2. Harness-text editing trigger (activation implies): read **all** topic skills you touch — at minimum `mstar-phase-gates`, `mstar-conventions`, `mstar-artifacts`, `mstar-branch-worktree`, `mstar-review-qc`, `mstar-coding-behavior`, plus host adapters — so prompts stay aligned with SSOT and do not re-duplicate rules
55
+ 3. New skill / major skill rewrite / trigger-description change (activation implies): MUST read `mstar-skill-authoring` before editing
56
+ 4. Typically: `mstar-conventions` (path symbols in examples)
57
+ 5. Host: `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`)
58
+
62
59
  ## Completion Report
63
60
 
64
61
  Template (`{role_id}` = `prompt-engineer`) → **`references/_shared/leaf-executor-core.md`**「Completion Report」。
@@ -1,15 +1,3 @@
1
- ## Morning Star Skills (Required Reading)
2
-
3
- Before any non-trivial QA assignment, read in order:
4
-
5
- 1. `mstar-harness-core` (entry, state machine, Done authority)
6
- 2. `mstar-coding-behavior` (verification discipline)
7
- 3. `mstar-dispatch-gates` + `mstar-branch-worktree` (anti-recursion; checkout alignment with QC)
8
- 4. Host adapter: `mstar-host` (detect; Read `references/opencode.md`, `cursor.md`, or `codex.md`)
9
- 5. **`references/qa-engineer/acceptance-gate.md`** (L4 execution)
10
- 6. **On demand:** `mstar-artifacts` (closing R#); `mstar-conventions` (paths); `mstar-design-md` (UI verify against DESIGN.md); `mstar-phase-gates` (when Assignment references verification phase); review bundle files and QC consolidated inputs named in Assignment
11
-
12
- Full cross-role matrix: `mstar-roles` SKILL.md.
13
1
 
14
2
  This file is a compact QA role shell.
15
3
  Detailed L4 procedures: `references/qa-engineer/*.md`.
@@ -61,6 +49,14 @@ When Assignment provides a report path, write report-only output under `{SDD_DIR
61
49
  ## Recommended owners
62
50
  ```
63
51
 
52
+ ## Skill Preset (PM-Activated)
53
+
54
+ External topic skills below are **presets activated by PM**, not unconditional role dependencies — the L4 acceptance identity and NEVER rules above stand alone, and role-owned `references/qa-engineer/acceptance-gate.md` is always part of this role (never preset-gated). Loading follows the Assignment **`Skill presets:`** field: omitted on an implementation / QC / QA round ⇒ the `standard` preset below applies by default; explicit `Skill presets: none` (or a trivial route) ⇒ work from identity + assignment and do not self-load topic skills. When active, load in order (**hub matrix:** `mstar-roles` SKILL.md):
55
+
56
+ 1. `mstar-harness-core` → `mstar-coding-behavior` → `mstar-dispatch-gates` + `mstar-branch-worktree` (anti-recursion; checkout alignment with QC)
57
+ 2. Host adapter: `mstar-host` (detect; Read `references/opencode.md`, `cursor.md`, or `codex.md`)
58
+ 3. On demand: `mstar-artifacts` (closing R#); `mstar-conventions` (paths); `mstar-design-md` (UI verify against DESIGN.md); `mstar-phase-gates` (Assignment references verification phase); review bundle files and QC consolidated inputs named in Assignment
59
+
64
60
  ## Completion Report
65
61
 
66
62
  Template (`{role_id}` = `qa-engineer`) → **`references/_shared/leaf-executor-core.md`**「Completion Report」。
@@ -10,23 +10,6 @@ Behavior is shared; reviewer identity is parameterized.
10
10
  - `{focus}`
11
11
  - `{report_suffix}`
12
12
 
13
- ## Required Skill Dependencies
14
-
15
- **Hub matrix:** `mstar-roles` SKILL.md.
16
-
17
- Before any non-trivial QC assignment, read in order:
18
-
19
- 1. `mstar-harness-core`
20
- 2. `mstar-dispatch-gates` + `mstar-branch-worktree`
21
- 3. `mstar-artifacts` (review bundle paths and naming)
22
- 4. Host: `mstar-host` → active host reference
23
- 5. **`references/qc-specialist/reviewer-workflow.md`**
24
- 6. **`references/qc-specialist/reviewer-checklist.md`**
25
- 7. **`references/qc-specialist/report-template.md`**
26
- 8. **On demand:** `references/qc-specialist/deep-review-lenses.md`; `mstar-conventions` (paths); `mstar-design-md` (UI vs DESIGN.md)
27
-
28
- This file is a compact QC reviewer shell.
29
- Detailed execution: `references/qc-specialist/*.md`.
30
13
 
31
14
  ## Role Mission
32
15
 
@@ -106,6 +89,16 @@ generated_at: "YYYY-MM-DD"
106
89
  Verdict enumeration and rules (incl. `Unconfirmed` semantics) → **`references/qc-specialist/report-template.md`**.
107
90
  ```
108
91
 
92
+ ## Skill Preset (PM-Activated)
93
+
94
+ External topic skills below are **presets activated by PM**, not unconditional role dependencies — the reviewer identity and NEVER rules above stand alone. Loading follows the Assignment **`Skill presets:`** field: omitted on an implementation / QC / QA round ⇒ the `standard` preset below applies by default; explicit `Skill presets: none` (or a trivial route) ⇒ work from identity + assignment and do not self-load topic skills. When active, load in order (**hub matrix:** `mstar-roles` SKILL.md):
95
+
96
+ Role-owned procedures — **always read with this file, never preset-gated**: `references/qc-specialist/reviewer-workflow.md`, `references/qc-specialist/reviewer-checklist.md`, `references/qc-specialist/report-template.md`; `references/qc-specialist/deep-review-lenses.md` on demand.
97
+
98
+ 1. `mstar-harness-core` → `mstar-dispatch-gates` + `mstar-branch-worktree` → `mstar-artifacts` (review bundle paths and naming)
99
+ 2. Host: `mstar-host` → active host reference
100
+ 3. On demand: `mstar-conventions` (paths); `mstar-design-md` (UI vs DESIGN.md)
101
+
109
102
  ## Completion Report
110
103
 
111
104
  Template (fill `{role_id}`) → **`references/_shared/leaf-executor-core.md`**「Completion Report」。
@@ -1,12 +1,3 @@
1
- ## Required Skill Dependencies
2
-
3
- **Hub matrix:** `mstar-roles` SKILL.md.
4
-
5
- **Always:** `mstar-harness-core`, `mstar-dispatch-gates`, `mstar-coding-behavior` (surgical edits).
6
-
7
- **Typically:** `mstar-conventions` (where deliverables land under `{HARNESS_DIR}` / `docs/`); `mstar-artifacts` (when writing under knowledge or plan trees).
8
-
9
- **Host:** `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`).
10
1
 
11
2
  ## Role Mission
12
3
 
@@ -80,6 +71,14 @@ One explanation has one home; essential contract facts may repeat locally. Each
80
71
  - **Atomic-move rule**: a move = remove + add + fixing every inbound link in the same change; no orphaned references may survive the change set.
81
72
  - **Tutorial vs reference**: user-facing docs are either a tutorial (ordered steps to an observable outcome) or a reference (explicitly scoped lookup).
82
73
 
74
+ ## Skill Preset (PM-Activated)
75
+
76
+ Topic skills below are **presets activated by PM**, not unconditional role dependencies — the identity, responsibilities, and NEVER rules above stand alone. Loading follows the Assignment **`Skill presets:`** field: omitted on an implementation / QC / QA round ⇒ the `standard` preset below applies by default; explicit `Skill presets: none` (or a trivial route) ⇒ work from identity + assignment and do not self-load topic skills. When active, load in order (**hub matrix:** `mstar-roles` SKILL.md):
77
+
78
+ 1. `mstar-harness-core` → `mstar-dispatch-gates` → `mstar-coding-behavior` (surgical edits)
79
+ 2. Typically: `mstar-conventions` (where deliverables land under `{HARNESS_DIR}` / `docs/`); `mstar-artifacts` (when writing under knowledge or plan trees)
80
+ 3. Host: `mstar-host` (detect; `references/opencode.md` | `cursor.md` | `codex.md`)
81
+
83
82
  ## Completion Report
84
83
 
85
84
  Template (`{role_id}` = `writing-specialist`) → **`references/_shared/leaf-executor-core.md`**「Completion Report」。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mstar-harness/opencode",
3
- "version": "3.2.5",
3
+ "version": "3.3.0",
4
4
  "description": "Morning Star harness OpenCode plugin — skills bootstrap + engine-backed runtime hooks (status lint, dispatch validation, Enforcement: hard gates).",
5
5
  "license": "MIT",
6
6
  "repository": {