Back to Skills

harness

verified

Use when you have a plan file from Claude Code plan mode and want to execute it autonomously - transforms plan markdown into execution config JSON for the mizu CLI with proper task extraction, permission inference, and verification commands

View on GitHub

Marketplace

mizu

brs98/mizu

Plugin

mizu

Repository

brs98/mizu

plugin/skills/harness/SKILL.md

Last Verified

January 15, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/brs98/mizu/blob/main/plugin/skills/harness/SKILL.md -a claude-code --skill harness

Installation paths:

Claude
.claude/skills/harness/
Powered by add-skill CLI

Instructions

# /harness Skill

Transform a Claude Code plan into an execution config for `mizu execute`.

## Usage

```
/harness                                    # Auto-detect recent plans
/harness ./.mizu/plans/2024-01-15-feature.md # Specific plan file
```

## Workflow

### Step 1: Find the Plan

**With argument:** Use that file directly.

**Without argument:** Scan `.mizu/plans/` for `.md` files. If multiple, use AskUserQuestion to let user choose.

### Step 2: Extract Tasks

**Try structured parsing first.** Look for numbered lists under:
- `## Implementation Steps`
- `## Tasks`
- `## Plan`

Parse: `1. Do something` → task

**If no standard format:** Use AI to extract tasks, then confirm with user via AskUserQuestion.

### Step 3: Infer Permissions

Start with `dev` preset. Analyze plan for keywords:

| Keywords | Add to inferred |
|----------|-----------------|
| docker, container | `docker` |
| database, postgres, psql | `psql` |
| aws, s3 | `aws` |

Show inferred permissions to user for confirmation.

### Step 4: Infer Verification Commands

| Task Pattern | Verification |
|--------------|--------------|
| "add tests", "write tests" | `bun test` |
| "fix build", "update build" | `bun run build` |
| "typecheck", "create types", "add types", "schema" | `bun run typecheck` |
| "lint", "fix lint" | `bun run lint` |

Leave as `null` for ambiguous tasks (worker self-verifies).

### Step 4b: Set Dependencies

**Default:** Make tasks sequential (each depends on previous).
- `task-001`: no dependencies
- `task-002`: depends on `["task-001"]`
- `task-003`: depends on `["task-002"]`

**Exception:** If tasks are clearly independent (e.g., "update docs" and "add tests" for different modules), they can run in parallel with same dependencies.

### Step 5: Generate Config

**CRITICAL FORMAT REQUIREMENTS:**

```json
{
  "version": "1.0.0",
  "planFile": "./<filename>.md",
  "projectDir": "/absolute/path/to/project",
  "model": "claude-sonnet-4-5",
  "tasks": [
    {
      "id": "task-00

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
3893 chars