CLI Reference

Complete reference for all /haiku:* commands

Complete reference for all H·AI·K·U commands. Commands are MCP prompts invoked as /haiku:<command> in any MCP client (Claude Code, Cursor, Windsurf, etc.).

Core Commands

/haiku:haiku-start

Create a new intent with studio and stage configuration.

  • Detects or prompts for studio selection (software, ideation, or custom)
  • Selects execution mode (continuous or discrete stages)
  • Resolves stages from the selected studio
  • Creates .haiku/intents/{slug}/ workspace with intent and unit files
  • Sets up git branch haiku/{slug} (software studio)

Arguments: description (optional) — describe what you want to build. template (optional) — instantiate from a studio intent template.

/haiku:haiku-pickup

Run the stage pipeline for the current intent. Progresses through each stage in order, transitioning through the hats defined in each stage's STAGE.md.

Arguments: intent (optional) — intent slug. Auto-detects if only one active intent.

/haiku:haiku-gate-review

Pre-delivery code review using multi-agent specialized review. Spawns parallel agents for correctness, security, performance, architecture, and test quality. Auto-fixes HIGH findings (up to 3 iterations).

Arguments: intent (optional) — intent slug.

/haiku:haiku-autopilot

Full autonomous workflow — create intent, run stages, review, and deliver in one command. Sets mode=autopilot and chains to /haiku:haiku-pickup.

Arguments: description (optional) — feature description.

/haiku:haiku-quick

Quick mode for small tasks — skip full pipeline. Streamlined single-stage workflow for fixes, renames, config changes, and small refactors.

Arguments: stage (optional) — stage name. description (required) — task description.

/haiku:haiku-zap

Zero-ceremony hat loop. No intent file, no unit decomposition, no workflow tick — runs the chosen stage's hats: sequence directly against the working tree as a chain of subagents (planner → builder → verifier). Parent skill commits once after the verifier returns PASS — <summary> with a confirmed Files list. Capped at 2 retries.

Use for: typos, one-line config tweaks, small bug fixes — work where the cost of a mistake is "edit and re-run." Use /haiku:haiku-quick or /haiku:haiku-start for anything that crosses stages or needs traceability.

Arguments: studio (optional, defaults to software) — studio slug. stage (optional, defaults to the studio's primary execution stage, e.g. development for software) — stage within the studio. description (required) — task description.

Preflight: zap refuses to start on a dirty working tree without explicit consent — it will list the dirty paths and ask whether to abort or proceed (and instruct the builder to leave those paths alone).

Intent Management

/haiku:haiku-refine

Refine intent or unit specs mid-execution without losing progress. Loads upstream stage context for scoped side-trips.

Arguments: stage (optional) — upstream stage to refine.

Reflection has no command — when an intent completes, the engine analyzes the run automatically along the active studio's reflection dimensions and writes the reflection artifact before sealing the intent.

Knowledge & Analysis

/haiku:haiku-ideate

Surface high-impact improvement ideas with adversarial filtering. Generates ideas across multiple dimensions and filters via counter-argument.

Arguments: area (optional) — focus area for brainstorming.

/haiku:haiku-adopt

Reverse-engineer an existing feature into H·AI·K·U intent artifacts. Explores a shipped feature by reading its code, tests, and docs, then generates intent and unit specs.

Arguments: description (optional) — feature description.

/haiku:haiku-capacity

Historical throughput analysis from local artifacts. Analyzes completed intents, units, and bolts to surface velocity trends and bottleneck stages.

Arguments: studio (optional) — scope analysis to a specific studio.

/haiku:haiku-changelog

Show the project changelog and release notes.

Arguments: version (optional) — specific version to show.

Quality & Process

/haiku:haiku-pressure-testing

Adversarial challenge for hat definitions. Applies RED-GREEN-REFACTOR cycle to test hat instructions under pressure types.

Arguments: hat (optional) — hat name to test.

Cross-Studio & Triggers

/haiku:haiku-composite

Create a multi-studio intent with sync points. Coordinates work across studios.

Arguments: description (optional) — what the composite intent addresses.

/haiku:haiku-triggers

Poll providers for events that unblock await gates or trigger new work.

Arguments: category (optional) — provider category to poll.

/haiku:haiku-backlog

Parking lot for ideas not yet ready for planning.

Arguments: action (optional) — add, list, review, or promote. description (optional) — for add action.

Managing Intents

Archiving is a soft-hide flag on the intent, not a move or delete — .haiku/intents/{slug} stays exactly where it is, branches and history untouched. Trigger it with /haiku:haiku-archive <slug> on anything completed, stale, or paused; archived intents drop out of /haiku:haiku-capacity and the default haiku_intent_list output. To see them, call haiku_intent_list with include_archived: true — the response tags each entry with an archived field so you can tell what's hidden. Restore with /haiku:haiku-unarchive <slug> and the intent is back in every default view.

/haiku:haiku-archive

Soft-hide an intent by setting an archived flag in its frontmatter — files stay in .haiku/intents/{slug}, history is preserved.

Arguments: intent (optional) — slug of intent to archive. If omitted, the skill prompts you to pick from the visible intents.

/haiku:haiku-unarchive

Clear the archived flag so the intent reappears in default list views.

Arguments: intent (optional) — slug of intent to restore. If omitted, the skill prompts you to pick from the archived intents.

/haiku:haiku-scaffold

Generate custom studios, stages, hats, and provider overrides.

Arguments: type (required) — studio, stage, hat, or provider. name (required) — name for the artifact. parent (optional) — parent context.

/haiku:haiku-migrate

Migrate legacy .ai-dlc intents to H·AI·K·U format.

Arguments: intent (optional) — specific intent slug to migrate.

/haiku:haiku-seed

Create intents from studio templates.

Arguments: action (optional) — plant, list, or check.

/haiku:haiku-setup

Configure H·AI·K·U providers and workspace settings.