From fb5d24ccfc0fc79f0e66dcd41e4837a2d8fc0d91 Mon Sep 17 00:00:00 2001
From: zap <zap@local>
Date: Thu, 12 Mar 2026 19:52:49 +0000
Subject: [PATCH] feat(skills): add delegation-router execution policy skill

---
 skills/delegation-router/SKILL.md | 113 ++++++++++++++++++++++++++++++
 1 file changed, 113 insertions(+)
 create mode 100644 skills/delegation-router/SKILL.md

diff --git a/skills/delegation-router/SKILL.md b/skills/delegation-router/SKILL.md
new file mode 100644
index 0000000..e03ff4c
--- /dev/null
+++ b/skills/delegation-router/SKILL.md
@@ -0,0 +1,113 @@
+---
+name: delegation-router
+description: Decide execution mode and model tier for tasks with low noise. Use when planning work and choosing between direct execution, spawning a subagent/fresh implementation session, or delegating via ACP sessions_spawn. Includes a routing matrix, complexity/risk model-tier policy (including Claude ACP tiers), fresh-session implementation rule, and practical sessions_spawn payload patterns.
+---
+
+# Delegation Router
+
+Use this as a fast preflight before implementation.
+
+## 1) Route selection matrix (direct vs subagent vs ACP)
+
+Choose the **least heavy path** that still gives reliable outcomes.
+
+| Task shape | Route | Default reason |
+|---|---|---|
+| Tiny, low-risk, 1-3 edits/commands, no long wait | **Direct in current session** | Lowest overhead, fastest feedback |
+| Multi-step implementation, broad file exploration, likely >10 min, or context getting long | **Subagent / fresh isolated session** | Keeps main session clean; better execution focus |
+| Explicit provider/runtime requirement (Claude/Codex/Pi) or model-specific quality need | **ACP via `sessions_spawn`** | Deterministic runtime + model control |
+| High-stakes review/architecture where correctness risk is high | **ACP high tier (or experienced subagent + review)** | Better reasoning headroom |
+
+Quick routing rules:
+- Stay **direct** for simple fixes and read-only checks.
+- Spawn **fresh implementation context** by default for non-trivial build/refactor/debug tasks.
+- Use **ACP** when runtime/model selection is itself part of the requirement.
+
+## 2) Model-tier policy
+
+Pick the lowest tier that safely meets quality.
+
+### Complexity bands
+
+- **Light**: small rewrite, single-file tweak, straightforward lookup, routine formatting.
+- **Medium**: multi-file feature/fix, moderate debugging, synthesis across several sources.
+- **Heavy**: architecture changes, ambiguous root-cause investigations, high-impact reviews, security-sensitive reasoning.
+
+### Tier map
+
+- **Light** → economy/fast tier
+  - Claude ACP: **Haiku 4.5**
+- **Medium** → balanced default
+  - Claude ACP: **Sonnet 4.6** (default)
+- **Heavy** → top-reasoning tier
+  - Claude ACP: **Opus 4.6**
+
+Escalate only when:
+- prior attempt failed quality bar,
+- ambiguity remains high after basic triage,
+- failure cost is materially high.
+
+## 3) Fresh-session implementation rule
+
+For non-trivial work:
+1. Scope and plan in current session.
+2. Write concise baton files (`WIP.md`, optionally `HANDOFF.md`) with goal, next actions, blockers, success criteria.
+3. Execute in a **fresh implementation session** (subagent or ACP run).
+4. Return with outcome + evidence (diff/tests/outputs), not long play-by-play.
+
+Do not drag long conversational context into implementation if file-based handoff is enough.
+
+## 4) `sessions_spawn` patterns (ACP examples)
+
+Use one clean spawn per coherent task (avoid noisy micro-spawns).
+
+### Light (Claude Haiku 4.5)
+
+```json
+{
+  "runtime": "acp",
+  "agentId": "claude",
+  "model": "claude-haiku-4-5",
+  "task": "Apply a small docs wording fix in docs/README.md and return exact diff."
+}
+```
+
+### Medium (Claude Sonnet 4.6, default)
+
+```json
+{
+  "runtime": "acp",
+  "agentId": "claude",
+  "model": "claude-sonnet-4-6",
+  "task": "Implement feature X across files A/B/C, run targeted tests, and summarize decisions."
+}
+```
+
+### Heavy (Claude Opus 4.6)
+
+```json
+{
+  "runtime": "acp",
+  "agentId": "claude",
+  "model": "claude-opus-4-6",
+  "task": "Review architecture tradeoffs for Y, propose final design, then implement with safety checks."
+}
+```
+
+If `sessions_spawn` is unavailable in the current tool surface, use the available delegation primitive (for example, `subagents`) and keep the same routing + tier logic.
+
+## 5) Low-noise defaults
+
+- Prefer one solid delegation run over many tiny ones.
+- Do not poll aggressively; rely on push completion or sparse status checks.
+- Keep instructions compact and outcome-based (goal, constraints, acceptance criteria).
+- Ask for only necessary artifacts: patch/diff, test result, short rationale.
+- Summarize back in 5-10 lines unless user asks for depth.
+
+## 6) Fast decision checklist
+
+- Is task tiny and safe? → direct.
+- Is it non-trivial implementation? → fresh session/subagent.
+- Do I need explicit runtime/model control? → ACP `sessions_spawn`.
+- Complexity/risk band? → Light/Medium/Heavy tier.
+- Can I reduce noise further? → fewer spawns, fewer polls, concise outputs.