CLI commands

The muster CLI is plain Node ESM. It makes no model calls. Every verb does deterministic work and prints JSON you can read or pipe. This is the layer that makes routing reproducible.

npx @adnova-group/muster <command> [args]

Routing and capabilities

Command	What it does
detect	Sniff the current project: languages, shape, greenfield flag.
capabilities	Walk the resolution ladder for every role; report the winner, full fallback chain, recommendations, and model.
match <task>	Rank every catalog provider against a free-text task by deterministic token overlap.
route <outcome>	Resolve which pipeline an outcome routes to.
domain <outcome>	Classify an outcome into a domain (pm, business, content, ops, software).
pipeline <id|domain>	Show the resolved pipeline definition.

Planning and orchestration

Command	What it does
manifest validate <file>	Validate a Crew Manifest's shape.
wave <file>	Compute dependency-ordered execution waves from a manifest.
plan-checklist <file>	Render the plan as a checklist (--done <ids> ticks completed tasks).
tally <file> / pick <file>	Tally tournament votes and pick a winner.

Scoring and prioritization

Command	What it does
score <file>	Score an artifact against a gate using the floor principle.
prioritize <file> [--model rice|ice|wsjf|weighted]	Rank initiatives deterministically. See below.

Prioritization models

prioritize does the arithmetic; the model only supplies the factor estimates. Given the same inputs, the same ranking. Every model fails loud on non-finite, non-positive, or zero-denominator inputs.

Model	Formula	Item fields
rice (default)	(reach × impact × confidence) / effort	reach, impact, confidence, effort
ice	impact × confidence × ease	impact, confidence, ease
wsjf	costOfDelay / jobSize	costOfDelay, jobSize
weighted	Σ (weightᵢ × scoreᵢ)	criteria: [{ weight, score }]

# rank a JSON file of initiatives with WSJF
npx @adnova-group/muster prioritize initiatives.json --model wsjf

The input file is either an array of items or { "items": [...], "model": "wsjf" }. A --model flag overrides the file's model.

Failure-first and review

Command	What it does
diagnose <symptom>	Structure a failure-first bug fix (--ci <file> to read CI output).
audit	Drive the whole-codebase review and fix.
issue <ref>	Resolve a GitHub issue reference into an outcome (title + body).
assess <outcome>	Deterministic gap-check: is the outcome clear enough to route?
steer <message>	Classify a mid-run steering message (approve, stop, status, retarget).

Ops and setup

Command	What it does
install [home]	Copy the output style and print the plugin-install steps.
uninstall [home]	Print the plugin-removal steps and clean up legacy style files.
setup [dir]	Scaffold Muster files into a target directory.
vendor	Generate built-in agents and skills from vendor/manifest.yaml.
doctor	Health-check the installation.
profile	Report the resolved provider profile.
signals [dir]	Surface project signals.
scratchpad <runId>	Read a run's scratchpad.
memory read / memory write ...	Read and write Muster's memory store.

TIP

Run any verb with no arguments to see its usage. The CLI fails loud with a clear message on bad input.