superpowers-muse routing overlay

# superpowers-muse

A routing overlay for the stock [Superpowers](https://github.com/obra/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:
   ```sh
   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.