@mstar-harness/opencode 3.1.2 → 3.2.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.
- package/CHANGELOG.md +27 -0
- package/dist/mstar.js +200 -113
- package/harness-commands/codebase-audit.md +3 -3
- package/harness-commands/iteration-drive.md +9 -90
- package/harness-commands/iteration-loop.md +22 -62
- package/harness-commands/iteration-start.md +20 -77
- package/harness-commands/pr-deep-review.md +37 -0
- package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/SKILL.md +3 -3
- package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/references/knowledge-and-designs.md +8 -8
- package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/references/plan-files-and-reports.md +6 -6
- package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/references/status-and-residuals.md +3 -3
- package/harness-skills/mstar-artifacts/templates/README.md +7 -0
- package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/templates/plan.main.md +1 -1
- package/harness-skills/mstar-audit/SKILL.md +36 -89
- package/harness-skills/mstar-audit/references/audit-playbook.md +1 -1
- package/harness-skills/mstar-audit/references/codebase-audit.md +85 -0
- package/harness-skills/mstar-audit/references/pr-review.md +139 -0
- package/harness-skills/mstar-branch-worktree/SKILL.md +5 -5
- package/harness-skills/mstar-compound/SKILL.md +4 -4
- package/harness-skills/mstar-compound/references/compound-workflow.md +1 -1
- package/harness-skills/mstar-compound-refresh/SKILL.md +4 -4
- package/harness-skills/mstar-compound-refresh/references/project-knowledge-bootstrap.md +3 -3
- package/harness-skills/{mstar-plan-conventions → mstar-conventions}/SKILL.md +9 -9
- package/harness-skills/{mstar-plan-conventions → mstar-conventions}/references/artifact-storage-paths.md +13 -13
- package/harness-skills/{mstar-plan-conventions → mstar-conventions}/references/harness-bootstrap-and-agents-layering.md +5 -5
- package/harness-skills/mstar-design-md/SKILL.md +3 -3
- package/harness-skills/mstar-dispatch-gates/SKILL.md +3 -3
- package/harness-skills/mstar-engine-legacy/SKILL.md +1 -1
- package/harness-skills/mstar-engine-legacy/references/lease-protocol.md +1 -1
- package/harness-skills/mstar-engine-legacy/references/status-field-history.md +1 -1
- package/harness-skills/mstar-harness-core/SKILL.md +21 -20
- package/harness-skills/mstar-host/references/_shared/plan-mode-bridge-core.md +5 -5
- package/harness-skills/mstar-host/references/cursor-plan-mode-bridge.md +7 -7
- package/harness-skills/mstar-host/references/cursor.md +1 -1
- package/harness-skills/mstar-host/references/kimi-plan-mode-bridge.md +1 -1
- package/harness-skills/mstar-host/references/omp-plan-mode-bridge.md +1 -1
- package/harness-skills/mstar-host/references/parallel-dispatch.md +1 -1
- package/harness-skills/mstar-host/references/zcode-plan-mode-bridge.md +1 -1
- package/harness-skills/mstar-iteration/SKILL.md +21 -15
- package/harness-skills/mstar-iteration/references/command-shared-invariants.md +62 -0
- package/harness-skills/mstar-iteration/references/iteration-artifact-boundaries.md +1 -1
- package/harness-skills/mstar-iteration/references/phase-2-worktree-lease.md +5 -5
- package/harness-skills/mstar-iteration/references/phase-3-iteration-close.md +1 -1
- package/harness-skills/mstar-iteration/references/phase-4-5-pr-delivery.md +1 -1
- package/harness-skills/mstar-iteration/references/phase5-helper-discovery.md +1 -1
- package/harness-skills/mstar-phase-gates/SKILL.md +5 -5
- package/harness-skills/mstar-project-governance/SKILL.md +9 -9
- package/harness-skills/mstar-review-qc/SKILL.md +4 -4
- package/harness-skills/mstar-roles/SKILL.md +7 -7
- package/harness-skills/mstar-roles/references/_shared/leaf-executor-core.md +20 -2
- package/harness-skills/mstar-roles/references/architect.md +7 -10
- package/harness-skills/mstar-roles/references/code-reviewer.md +7 -10
- package/harness-skills/mstar-roles/references/frontend-dev.md +6 -5
- package/harness-skills/mstar-roles/references/fullstack-dev-shared.md +6 -5
- package/harness-skills/mstar-roles/references/ops-engineer.md +3 -7
- package/harness-skills/mstar-roles/references/product-manager.md +8 -11
- package/harness-skills/mstar-roles/references/project-manager/dispatch-and-assignment.md +1 -1
- package/harness-skills/mstar-roles/references/project-manager/plan-management.md +3 -3
- package/harness-skills/mstar-roles/references/project-manager/qa-trigger-matrix.md +2 -2
- package/harness-skills/mstar-roles/references/project-manager/qc-and-residuals.md +3 -3
- package/harness-skills/mstar-roles/references/project-manager.md +5 -5
- package/harness-skills/mstar-roles/references/prompt-engineer.md +4 -7
- package/harness-skills/mstar-roles/references/qa-engineer/acceptance-gate.md +2 -2
- package/harness-skills/mstar-roles/references/qa-engineer.md +4 -8
- package/harness-skills/mstar-roles/references/qc-specialist/report-template.md +1 -1
- package/harness-skills/mstar-roles/references/qc-specialist/reviewer-workflow.md +1 -1
- package/harness-skills/mstar-roles/references/qc-specialist-shared.md +5 -8
- package/harness-skills/mstar-roles/references/writing-specialist.md +3 -6
- package/harness-skills/mstar-sdd/SKILL.md +2 -2
- package/harness-skills/mstar-sdd/references/file-handoffs.md +1 -1
- package/harness-skills/mstar-strategy/SKILL.md +8 -38
- package/package.json +1 -1
- package/harness-skills/mstar-plan-artifacts/templates/README.md +0 -7
- /package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/references/plan-quality-bar.md +0 -0
- /package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/templates/status.empty.json +0 -0
- /package/harness-skills/{mstar-plan-conventions → mstar-conventions}/references/effort-estimation.md +0 -0
|
@@ -7,7 +7,7 @@ description: Morning Star 全局战略方向 —— 创建并维护 `STRATEGY.md
|
|
|
7
7
|
|
|
8
8
|
## Load order
|
|
9
9
|
|
|
10
|
-
**Read `mstar-harness-core` first.** Path symbols → **`mstar-
|
|
10
|
+
**Read `mstar-harness-core` first.** Path symbols → **`mstar-conventions`**. On conflict, **`mstar-harness-core` wins**.
|
|
11
11
|
|
|
12
12
|
## Purpose
|
|
13
13
|
|
|
@@ -17,7 +17,7 @@ Without a strategy document, decisions are made in isolation — each plan misse
|
|
|
17
17
|
|
|
18
18
|
## 产物存储位置
|
|
19
19
|
|
|
20
|
-
**SSOT**: `mstar-
|
|
20
|
+
**SSOT**: `mstar-conventions/references/artifact-storage-paths.md`。STRATEGY.md → `<repo-root>/STRATEGY.md`(与 `.git/`、`AGENTS.md` 同级)。**禁止**放入 `{HARNESS_DIR}`、`docs/` 或任何子目录。
|
|
21
21
|
|
|
22
22
|
## When to use
|
|
23
23
|
|
|
@@ -68,15 +68,9 @@ A good strategy document is opinionated and concise. It should fit in one screen
|
|
|
68
68
|
|
|
69
69
|
## Creating STRATEGY.md
|
|
70
70
|
|
|
71
|
-
|
|
71
|
+
Creating and maintaining `STRATEGY.md` follows the **project knowledge bootstrap**: **`mstar-compound-refresh`** → `references/project-knowledge-bootstrap.md` **Phase 2 (Distill STRATEGY.md)** — survey context → interview → draft/review → stale/partial/current handling. The six-section structure and the engine check above stay authoritative here.
|
|
72
72
|
|
|
73
|
-
|
|
74
|
-
2. If `{KNOWLEDGE_DIR}` or `{ITERATION_DIR}` exist, scan for architectural decisions and patterns.
|
|
75
|
-
3. If `CONCEPTS.md` exists, use it to understand domain vocabulary.
|
|
76
|
-
|
|
77
|
-
### Phase 2: Interview
|
|
78
|
-
|
|
79
|
-
Ask PM these questions (one at a time):
|
|
73
|
+
### Interview (ask PM the 5 questions one at a time)
|
|
80
74
|
|
|
81
75
|
1. "What is the one-sentence vision for this project?"
|
|
82
76
|
2. "Who are the primary users and what do they need most?"
|
|
@@ -84,33 +78,9 @@ Ask PM these questions (one at a time):
|
|
|
84
78
|
4. "What 2-3 principles should guide every technical decision?"
|
|
85
79
|
5. "What technology bets have you made, and why?"
|
|
86
80
|
|
|
87
|
-
###
|
|
88
|
-
|
|
89
|
-
Write STRATEGY.md at the repo root. Keep it concise — each section should be 1-3 sentences or a short bullet list.
|
|
90
|
-
|
|
91
|
-
### Phase 4: Discoverability
|
|
92
|
-
|
|
93
|
-
Check if AGENTS.md references STRATEGY.md. If not, propose adding:
|
|
94
|
-
|
|
95
|
-
```markdown
|
|
96
|
-
- `STRATEGY.md` — project vision and guiding principles
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
Ask for consent before applying.
|
|
100
|
-
|
|
101
|
-
## Maintaining STRATEGY.md
|
|
102
|
-
|
|
103
|
-
### Review triggers
|
|
104
|
-
|
|
105
|
-
- After a major architectural decision
|
|
106
|
-
- When a plan introduces a new technology stack
|
|
107
|
-
- Quarterly review (scheduled by PM)
|
|
108
|
-
|
|
109
|
-
### Update rules
|
|
81
|
+
### Maintenance
|
|
110
82
|
|
|
111
|
-
|
|
112
|
-
2. **Log decisions with context.** The Decision Log captures *why* a choice was made, not just what.
|
|
113
|
-
3. **Keep it current.** Stale strategy is worse than no strategy — it misdirects plans.
|
|
83
|
+
Review triggers: after a major architectural decision, when a plan introduces a new technology stack, or quarterly (PM-scheduled). Update rules: be decisive about direction changes (replace, don't keep old strategy alongside new); log decisions with context (why, not just what); keep it current — stale strategy is worse than no strategy.
|
|
114
84
|
|
|
115
85
|
## STRATEGY.md vs other docs
|
|
116
86
|
|
|
@@ -131,7 +101,7 @@ Ask for consent before applying.
|
|
|
131
101
|
|
|
132
102
|
## Workflow
|
|
133
103
|
|
|
134
|
-
|
|
104
|
+
主链:**创建/维护**(survey → 访谈 = 五问 → draft/review → 更新/替换/跳过)细节 → **`mstar-compound-refresh`** `references/project-knowledge-bootstrap.md` **Phase 2**。作为 brainstorm / plan 的上游锚点被引用。
|
|
135
105
|
|
|
136
106
|
## Evidence
|
|
137
107
|
|
|
@@ -141,4 +111,4 @@ Ask for consent before applying.
|
|
|
141
111
|
|
|
142
112
|
- 迭代级战略对齐(iteration-start §1.1 读 STRATEGY.md)→ **`mstar-iteration`**
|
|
143
113
|
- 知识维护 / bootstrap(战略变更后的知识对账)→ **`mstar-compound-refresh`**
|
|
144
|
-
- 路径符号与产物存储 SSOT → **`mstar-
|
|
114
|
+
- 路径符号与产物存储 SSOT → **`mstar-conventions`**
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mstar-harness/opencode",
|
|
3
|
-
"version": "3.
|
|
3
|
+
"version": "3.2.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": {
|
|
@@ -1,7 +0,0 @@
|
|
|
1
|
-
# Plan harness file templates
|
|
2
|
-
|
|
3
|
-
Copy these into `{HARNESS_DIR}` when bootstrapping a project. Path symbols (`{HARNESS_DIR}`, `{PLAN_DIR}`, …) → **`mstar-plan-conventions`**. Field semantics and residual lifecycle → **`mstar-plan-artifacts/references/status-and-residuals.md`**. Optional rollup: engine `techDebtRollup` import (read-only; see that reference).
|
|
4
|
-
|
|
5
|
-
| File | Copy to | Notes |
|
|
6
|
-
|------|---------|--------|
|
|
7
|
-
| `status.empty.json` | `{HARNESS_DIR}/status.json` | The **v2 root register** shape (`version: 2`, `updated_at`, `workflows: []`) — see **`mstar-plan-artifacts` SKILL.md** + `references/status-and-residuals.md`. Replace `updated_at` with the real date. Per-lifecycle snapshot / register / lease fields are created at runtime by engine writers (`workflows/<id>/snapshot.json`, `projects/<id>/residuals.json`) — not in the empty template. |
|
/package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/references/plan-quality-bar.md
RENAMED
|
File without changes
|
/package/harness-skills/{mstar-plan-artifacts → mstar-artifacts}/templates/status.empty.json
RENAMED
|
File without changes
|
/package/harness-skills/{mstar-plan-conventions → mstar-conventions}/references/effort-estimation.md
RENAMED
|
File without changes
|