pi-dispatch

Pi-Dispatch Skill

Describes how to delegate coding plans to orchestrated teams of pi agents. Claude's role: write JSON → run script → read JSON.

Path convention: {{SKILL_DIR}} = the directory containing this SKILL.md. Resolve it from the file path you used to read this skill. All paths below are relative to {{SKILL_DIR}}.

When to Use

Use pi-dispatch for any pi agent work. Use the native Agent tool for Claude subagents (sonnet/opus/haiku).

Config

{{SKILL_DIR}}/config.json — edit pi_models to swap models, default_timeout_minutes for global default.

{
  "provider": "openrouter",
  "default_timeout_minutes": 5,
  "task_routing": {
    "hard": { "pi_tier": "hard" },
    "moderate": { "pi_tier": "hard" },
    "easy": { "pi_tier": "easy" },
    "mechanical": { "pi_tier": "easy" },
    "verification": { "pi_tier": "easy" }
  },
  "pi_models": {
    "hard": ["xiaomi/mimo-v2.5-pro", "z-ai/glm-5.1"],
    "easy": [
      "qwen/qwen3.6-plus",
      "deepseek/deepseek-v4-pro",
      "z-ai/glm-5-turbo"
    ]
  }
}

Step 1 — Write the dispatch JSON

Write to .pi_agent_dispatch/<YYYYMMDDTHHmmss>.json:

{
  "spawned_at": "2026-05-02T10:00:00",
  "task": "one-line description",
  "agents": [
    {
      "id": "research",
      "task_type": "easy",
      "timeout_minutes": 10,
      "depends": [],
      "prompt": "Full self-contained prompt. End with: \"Output a concise summary of changes made.\"\nUse relative paths — pi runs inside the worktree."
    },
    {
      "id": "implement",
      "task_type": "hard",
      "depends": ["research"],
      "prompt": "..."
    },
    {
      "id": "tests",
      "task_type": "easy",
      "depends": ["implement"],
      "prompt": "..."
    },
    {
      "id": "docs",
      "task_type": "mechanical",
      "depends": ["implement"],
      "prompt": "..."
    },
    {
      "id": "special",
      "pi_model": "xiaomi/mimo-v2.5-pro",
      "depends": ["tests", "docs"],
      "prompt": "..."
    }
  ]
}