superpowers-muse

A routing overlay for the stock Superpowers
plugin for Claude Code. Superpowers keeps owning the process — brainstorming,
plans, task briefs, worktrees, the fix loop, the ledger — while this skill
decides who performs each role: a cheap external model writes the code, Codex
reviews it, and a few rules stop the expensive models from being used badly.

How it relates to stock Superpowers

• Unchanged: every stock skill, script and artifact. Nothing in the plugin
  directory is modified; the workspace, briefs, review packages and
  progress.md ledger stay exactly where stock puts them.
• Replaced: the performers. Stock dispatches Claude subagents as implementer
  and reviewer; here the implementer is Muse Spark 1.3 Contributor through
  OpenCode (or a Claude Opus subagent when judgment matters more than cost), and
  the reviewers are Codex gpt-5.6-sol and gpt-6-astra.
• Added: a deck of workers with costs and strengths, ten invariants the
  coordinator may not trade away, defaults, thin CLI wrappers with anchored
  verdict contracts, and reviewer prompts derived from the stock ones.

Prerequisites

• Claude Code ≥ 2.1.x with superpowers@claude-plugins-official installed and
  enabled (claude plugin list).
• Codex CLI, signed in, with access to gpt-5.6-sol and gpt-6-astra.
• OpenCode ≥ 1.18.
• A Meta Model API key with muse-spark-1.3-contributor enabled and its
  data-use terms accepted.
• Git. On Windows, Git Bash (Claude Code's Bash tool runs it).

Install

1. Copy the skill:

   cp -r superpowers-muse "$HOME/.claude/skills/"
   

2. Append the contents of CLAUDE.global.md to $HOME/.claude/CLAUDE.md
   (create the file if it does not exist). That is what makes the routing apply
   in every session.
3. Set MODEL_API_KEY as a user environment variable (Windows: Edit
   environment variables for your account; POSIX: your shell profile). The
   scripts never take it as an argument and never print it.
4. Optional environment:
   • OPENCODE_EXE — full path to the OpenCode binary if it is not on PATH.
   • OPENCODE_MUSE_STATE — where this skill keeps OpenCode state (default
     %LOCALAPPDATA%\opencode-muse, or
     ${XDG_STATE_HOME:-$HOME/.local/state}/opencode-muse).
5. Start a new Claude Code session so the skill and CLAUDE.md are loaded.