This repository provides the Morning Star multi-agent code harness framework.

Core value:

• Start a usable multi-role workflow quickly
• Run with unified mstar-* skills instead of scattered rules
• Reuse one core process across OpenCode, Cursor, and Codex

• Use the mstar-harness CLI (npm package @mstar-harness/cli):
  • npx @mstar-harness/cli init
  • or bunx @mstar-harness/cli init
• init provides a target-aware guided setup so installation and baseline config happen in one flow.
• CLI target support currently includes:
  • opencode
  • cursor

For full CLI usage and advanced options (--yes, --dry-run, --output, doctor) including Cursor target install modes, see docs/cli.md.

Manual install targets currently include:

• opencode
• cursor
• codex

• Plugin install:
  • Add plugin config in opencode.json:

    {
      "$schema": "https://opencode.ai/config.json",
      "plugin": [
        "superpowers@git+https://github.com/obra/superpowers.git",
        "@mstar-harness/opencode@latest"
      ]
    }

  • Restart OpenCode
• The OpenCode plugin resolves skills and agents only inside @mstar-harness/opencode (not process.cwd()). Published builds ship harness-skills/ and harness-agents/. If you work from a git checkout of this repo, run bun install / npm install at the repo root so postinstall runs opencode:bundle-assets and populates those directories under packages/opencode/.

For detailed OpenCode setup and migration, see packages/opencode/INSTALL.md.

• Local plugin install (direct clone):
  • mkdir -p ~/.cursor/plugins/local
  • git clone https://github.com/btspoony/mstar-harness.git ~/.cursor/plugins/local/mstar-harness
  • Restart Cursor or run Developer: Reload Window

• Marketplace install:
  • codex plugin marketplace add https://github.com/btspoony/mstar-harness.git --sparse .codex/
  • Install Morning Star Harness from the added marketplace.

That completes installation.

• OpenCode: start with the Project Manager role (agents/project-manager.md, typically agent.project-manager in opencode.json).
• Cursor: use /pm to force-start with the Project Manager role.
• Codex: use /pm to force-start with the Project Manager role after installing the plugin.

flowchart TD
    A["PM: entry and intent clarification"] --> B{"PM: spec and context ready"}
    B -->|No| C["PM: clarify and refine requirements"]
    C --> B
    B -->|Yes| D["PM: initialize or load HARNESS_DIR and PLAN_DIR"]
    D --> E["PM: create or select active plan and update status.json SSOT"]
    E --> F["PM: task routing and assignment"]
    F --> G{"PM: work type"}
    G -->|Large or high-ambiguity| H["Explore, Product Manager, Architect pre-work"]
    H --> I["Dev team: implementation tracks"]
    G -->|Medium, small, or bugfix| I
    I --> J["Dev owners and PM: record notes and findings"]
    J --> K["QC specialists: QC review gate (default: QC trio parallel review)"]
    K --> L{"PM: consolidated QC decision"}
    L -->|Request Changes| M["PM: assign fixes to dev owners"]
    M --> I
    L -->|Approve or discussion resolved| N["QA engineer: verification"]
    N --> O{"PM and QA: residual findings remain"}
    O -->|Yes| P["PM: register residuals in status.json and schedule follow-up"]
    P --> Q["QA or PM: sign-off with traceable evidence"]
    O -->|No| Q
    Q --> R["PM: mark done and archive context"]

You can assign different models per agent in opencode.json without replacing your existing file.

This project is licensed under MIT. See LICENSE.