Skip to content

Autonomous Build

/mk:harness builds entire products from a description. It's for "build me a kanban app" scope — not single features (use /mk:cook for those). It runs a planner → contract → generator ⇄ evaluator loop with minimal handholding.

Quick start

bash
/mk:harness build a kanban board with drag-and-drop

MeowKit detects your model tier, selects the right scaffolding density, and drives the full build. You approve at Gate 1 (plan) and Gate 2 (review). The evaluator grades the running app against rubrics. If it fails, the harness loops back to the generator — up to 3 rounds.

When to use

SituationUse
Green-field product from scratch/mk:harness
Single feature on existing codebase/mk:cook
Bug fix/mk:fix

Scaffolding density

The harness adjusts automatically based on your model tier:

ModelDensityWhat runs
HaikuMINIMALShort-circuits to /mk:cook
SonnetFULLSprint contract + 1-3 iteration rounds
Opus 4.5FULLContract + full pipeline
Opus 4.6+LEANSingle-session, contract optional, 0-1 rounds

Override with --tier or MEOWKIT_HARNESS_MODE:

bash
/mk:harness build a todo app --tier full     # Force FULL density
/mk:harness build a retro game maker --tier lean  # Force LEAN

Budget control

bash
/mk:harness build a markdown editor --budget 25 --max-iter 2
  • Default budget: $100 hard cap (warns at $30)
  • --budget N overrides the cap
  • --max-iter N limits generator/evaluator rounds (default 3)

What gets produced

ArtifactLocation
Product plantasks/plans/{slug}/plan.md
Sprint contracttasks/contracts/{date}-{slug}-sprint-N.md
Evaluator verdicttasks/reviews/{slug}-evalverdict.md
Full audit trailtasks/harness-runs/YYMMDD-{slug}/run.md

Resuming after interruption

bash
/mk:harness --resume 260501-1450-build-kanban

Picks up at the last completed step. Run reports are append-only — no work is lost.

Exit statuses

StatusMeaning
PASSEvaluator graded the build as passing
WARNMinor issues found, build is acceptable
FAILEvaluator rejected the build after 3 iterations
ESCALATEDHuman intervention required
TIMED_OUTBudget cap reached

Don't use /mk:harness for

  • Single features or bug fixes — use /mk:cook or /mk:fix
  • Doc updates or code reviews — use targeted skills
  • Analysis or explanation — harness is for building, not research

Next steps

Released under the MIT License.