btspoony/morning-star-harness

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

Morning Star codebase audit — survey any repository as a senior advisor and produce prioritized, self-contained improvement plans for the normal Prepare → Execute flow to pick up. Strictly read-only on source code. Use when asked to audit or survey a codebase, find improvement opportunities (bugs, security, performance, test gaps, tech debt, dependency upgrades, DX), suggest what to build next (direction/roadmap), or when the user says 'what should I improve / fix / refactor / upgrade in this codebase'. Dispatched by PM under Task category audit.

Morning Star 业务仓 Git 功能分支、worktree 隔离（L1 跨 plan：control worktree + 每 plan feature worktree + execution_lease，默认 gitignore 下经 control 绝对路径读写进程产物；L2 同 plan：references/parallel-writable-pre-dispatch.md，N 次 invoke ≠ 隔离）、Spec 集成分支、QC/QA 检出对齐（Review cwd / Working branch / plan_id / Review range / Diff basis 三审 + QA 逐字相同）。Read when PM writes Working branch / Branch policy, iteration/parallel writable dispatch, or QC/QA checkout alignment is needed.

Morning Star 跨角色通用编码行为准则 —— 任何实现、调试、重构、审查任务动手前必读。约束 Think Before Coding（先读懂再改、显式假设、不静默猜测）、Simplicity First（YAGNI、The Ladder、simplify: 标记、最小耐久切片）、Surgical Changes（改动可追溯、Bug 修根因先 grep 所有调用点、不 piggyback）、Debugging（先复现、一步一测、修前写复现测试）、Review Feedback Handling（先核实再改、证据反驳）、Goal-Driven Execution（非平凡逻辑留可运行检查、Step→verify）、Communication。@fullstack-dev* / @frontend-dev / @architect / @qa-engineer / @ops-engineer / @prompt-engineer 必读；QC 核对手术范围时必读。不覆盖分支门禁、QC/QA 路由、Assignment 权限。

Morning Star 知识结晶 —— 将已解决问题的经验沉淀为结构化知识文档，存入 {KNOWLEDGE_DIR}；迭代收口时从 {ITERATION_DIR}/<iteration-id>/ package 提升 specs/guides。支持 Bug track 与 Knowledge track 双轨。含重叠检测、可发现性检查、CONCEPTS.md 协同。触发：iteration-close（mstar-iteration §3.2）或独立触发。产出：{KNOWLEDGE_DIR}/<category>/<slug>.md。

Morning Star 知识维护与项目知识 bootstrap —— 审查 {KNOWLEDGE_DIR} 文档是否仍准确、去重叠合并、清理过期知识；或从代码库提炼 STRATEGY.md、CONCEPTS.md、基线 knowledge 脚手架（无/残旧/空白 knowledge）。触发：mstar-compound 发现可合并文档、定期维护、项目缺 STRATEGY.md/CONCEPTS.md/{KNOWLEDGE_DIR}、stale knowledge scaffolding、显式 bootstrap 请求、或显式 refresh。产出：更新/合并/删除知识文档 + 维护报告；或 bootstrap 产物（STRATEGY.md、CONCEPTS.md、基线 knowledge）。

DESIGN.md design system specification for Morning Star projects. Create, audit, and maintain project-level design tokens (Colors, Typography, Spacing, Elevation, Motion, Shapes, Components, Voice & Content) using Vercel Geist as reference template. Three-level completeness checklist (MVP/Standard/Production) with built-in upgrade placeholders. Supports light/dark dual-theme via DESIGN.md + DESIGN.dark.md sharing same token names with different values. Prepare 阶段由 @architect 主责创建，@product-manager 提供设计需求；@frontend-dev / @fullstack-dev 实现 UI 时消费；@qc-specialist / @qa-engineer 审查 UI 对齐 DESIGN.md。Read when PM assigns DESIGN.md creation in Prepare, initiating a new UI project, @architect defining a design system, implementing styled components, auditing UI against design spec, adding dark theme, or user mentions "DESIGN.md" / "design tokens" / "design system". Phase gate → **mstar-phase-gates**; paths → **mstar-plan-conventions**.

Morning Star 派发与委派门禁 —— 仅 PM 可增派 subagent、Execute as 与 Delegation、承接方反递归 NEVER 红线、SDD implement 串行派发、**SDD 路径 plan QC 强制 tri-review（N=3）**、inline 单席 QC 例外、Assignment 文案≠派发、未齐不发、**invoke 角色字段必填（漏写=静默 generic 回退=派发未完成）**。project-manager 派发时必读；leaf 动手前必读反递归。worktree 见 mstar-branch-worktree；SDD 见 mstar-sdd；宿主见 mstar-host。

Morning Star (启明星) harness **强制全局入口** —— 信息源优先级、最小交付循环、状态机与 Done 权限、Task category 路由（含 quick 禁豁免）、@explore 边界、长任务纪律、护栏不变量、反模式索引、Morning Star Skill 索引与宿主入口。**任何**非平凡任务开始前必须先 Read 本 skill；再按角色与任务 **按需** Read 其它 mstar-* 专题（勿默认通读全部）。@project-manager 开轮必读 + mstar-dispatch-gates / mstar-phase-gates / mstar-plan-conventions 等；实现/审查/QA 必读本 skill + mstar-coding-behavior 及角色清单（见 mstar-roles）。Prepare/派发/Git/residual/QC 细则在专题 skill，不在此重复。

Morning Star host adapter (OpenCode, Cursor, Codex, Kimi, ZCode, omp, dsh). Use after mstar-harness-core whenever host entry, clarify, dispatch, or plan UX differs by platform - OpenCode question/task-tool subagent invoke, Cursor /pm and CreatePlan/SwitchMode dual-write and Task parallel QC, Codex plugin skills plus Plan/Goal Mode, Kimi Agent/AgentSwarm with built-in subagent types only (coder/explore/plan) and role-in-prompt binding, ZCode Agent/AskUserQuestion/EnterPlanMode with built-in subagent types and role-in-prompt binding, omp task/ask/hub preferring live-schema role agents (agents/*.md) with C5b skill-load binding (generic task/scout only as fallback), dsh (DeepSeek Harness) subagent tool with in-process engine gates and bundled mstar commands, sandboxed tools, and tool discovery. Auto-detect host from session tools; then Read references/<host>.md. Always load after mstar-harness-core.

Morning Star 迭代管理 —— Phase 1（默认 interactive direction lock；opt-in autonomous；specs + <iteration-id>/ package；禁止直写 knowledge）、Autonomous Execute、iteration-close（compound 提升 package → knowledge）、PR 交付、PR merge-ready loop。分支 SSOT：status.json + compass frontmatter。

Morning Star Spec-Driven 双阶段门禁：Prepare（specify → clarify → plan）、Execute（plan(locked) → tasks → implement；多 task 默认 Execution mode: sdd）。覆盖意图门禁、长期目标优先、分批 roadmap 强制落盘、clarify 纪律、hotfix 压缩路径、可验证编辑、Phase Gate 最小证据。Read when judging Prepare/Execute gates, before first implement dispatch, when product/architect enter Prepare, or to justify not skipping plan/clarify. @project-manager 每轮非 hotfix 必读；@product-manager/@architect 锁规格/plan 必读 Prepare；实现角色读 Execute + hotfix 例外。quick 禁豁免规则在 mstar-harness-core。

Morning Star plan harness artifacts — {PLAN_DIR} main plans and durable review summaries, {SDD_DIR}/review/ ephemeral QC/QA bundles, {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/QA review bundles, 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 writing review bundle reports; @qa-engineer before closing R# when QA gate: mandatory. Verdict rules: leaf → mstar-roles/references/qc-specialist/report-template.md; PM → mstar-review-qc. Paths in mstar-plan-conventions.

Morning Star (启明星) harness 计划目录约定 —— {HARNESS_DIR} / {PLAN_DIR} / {SDD_DIR} / {ITERATION_DIR} / {KNOWLEDGE_DIR} / {SPECS_DIR} 发现与初始化（默认 .mstar/，兼容 .agents/）、docs 与 harness 子树边界、review bundle、未启用 plan 时的工作方式、Spec 集成分支与多 Plan 实现分支（显式 base / merge 靶 / PR target）、Morning Star plan-writing path gate、工期预估（agent-oriented）。**必须**在读写 .mstar/ / .agents/、初始化 harness、编排含 plan 的任务、或对齐 metadata.primary_spec 时 Read；@project-manager 开 plan 任务前必读。plan 文件 / status / residual / review bundle / knowledge → **mstar-plan-artifacts**；分支与 QC 检出 → **mstar-branch-worktree**。

Morning Star QC orchestration — **SDD mandatory plan QC tri-review** ({SDD_DIR}/review/qc1.md…qc3.md + consolidated); inline/hotfix single-seat (qc.md in review bundle); PM dispatch timing, tri identity gate, residual registration contract, layer boundaries, durable plan summary. Leaf QC execution → **mstar-roles/references/qc-specialist/**. Per-task review is **mstar-sdd** (L2). Primary reader: **project-manager** when dispatching or consolidating QC.

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**.

Morning Star subagent-driven development (SDD) — file handoff, per-task implementer + task reviewer (L2), progress ledger, branch review-package for plan QC tri (L3). **Implementer session** fresh (default) or **sticky** (same dev subagent across tasks — references/sticky-implementer-session.md). **Must** Read when project-manager runs Execution mode: sdd (multi-task plan, single-plan, or iteration Phase 2), dispatches SDD implementer/reviewer subagents, or prepares review-package paths. Leaf implementer/reviewer subagents skip PM sections via SUBAGENT-STOP in dispatch prompts.

Agent skill 撰写 / 重写 / 优化规范（SkillsBench 实验门控）。在新建任意 skill、大改 SKILL.md、改写 description 触发契约、压缩过长 body、评审 skill 结构、或判断某段行为塑形文案是否值得保留时读取。适用于任何领域的 skill，不限于本仓库专题；不用于普通应用实现。

Morning Star 全局战略方向 —— 创建并维护 STRATEGY.md（项目级战略文档），作为 brainstorm/plan 的上游锚点。定义产品愿景、技术方向、不做事项、决策原则。触发：项目初始化、方向性决策变更、或 PM 要求战略对齐时。

PM entry shim — force project-manager orchestration when user invokes /pm or this skill (Codex, Cursor, OpenCode, Kimi, ZCode, and omp). General per-plan PM work: this skill + project-manager.md. Formal iteration lifecycle: mstar-iteration (host commands/ may orchestrate Phase 1–5). Boot, routing, dispatch SSOT → mstar-roles/references/project-manager.md and topic mstar-* skills — not here.