diff --git a/claude-plugins/plugins/base/skills/claude-subagents/SKILL.md b/claude-plugins/plugins/base/skills/claude-subagents/SKILL.md index 352ebf9f5..d3d667f27 100644 --- a/claude-plugins/plugins/base/skills/claude-subagents/SKILL.md +++ b/claude-plugins/plugins/base/skills/claude-subagents/SKILL.md @@ -52,13 +52,36 @@ Model choice, prompt hygiene, splitting big batches, verify-then-report — everything else in this skill — applies exactly the same whether you're calling the tool or thinking through the recipe by hand. +## Model choice + +Pick the cheapest model that can do the job, and lean toward the cheap end +more readily than you might for your own work — a subagent is throwaway +compute, not a peer you're rationing. Haiku in particular is cheap enough +that you don't need to be precious about spinning one up: for a mechanical, +well-scoped batch (the shape this skill is for), reach for it liberally +rather than defaulting to a bigger model "to be safe." On a small context +Haiku costs next to nothing up to `high` effort, so there's no cost reason +to cap its effort at `medium` by reflex. Effort is a real lever on Haiku +though: at `max` it behaves like a slightly weaker Sonnet at about the cost +of Sonnet on `low`, so `max` on Haiku buys nothing over Sonnet on `low`. +Stay at `high` or below, and move to a stronger model when the batch needs +more judgement (see Pitfalls below). When you do pick Sonnet, pass `low` +yourself: its default effort is `high`, a big price bump. + +This isn't "always pick the smallest model regardless of task" — a batch +that actually needs judgement calls still wants a stronger model (see +Pitfalls below). It's "don't under-use Haiku out of habit-driven caution +when the task is mechanical enough for the skill to apply at all." + ## Effort An omitted `effort` defaults to `medium` here — cheaper than claude's own model default (`high` on most models), a deliberate cost-conscious choice -for subagent work specifically, same spirit as "cheaper-than-you" model -choice above. Raise it explicitly when the task is complex enough to -actually need deeper reasoning, not as a reflex. +for subagent work specifically, same spirit as the model-choice guidance +above. Raise it explicitly when the task is complex enough to actually +need deeper reasoning, not as a reflex. **Exception: on Haiku with a small +context, cost stays near zero up to `high`.** See Model choice above: skip this +default-medium caution there, but keep `max` for a stronger model. Anthropic's own levels (per current Claude Code docs — names/availability are model-dependent, check before relying on an exact list): `low`, diff --git a/hive-subagent-mcp/src/mcp.rs b/hive-subagent-mcp/src/mcp.rs index cbe70b189..76f528fab 100644 --- a/hive-subagent-mcp/src/mcp.rs +++ b/hive-subagent-mcp/src/mcp.rs @@ -44,9 +44,11 @@ struct StartArgs { /// session under that name is done — rejected while one under the same /// name is still running. name: String, - /// Which model the subagent's own session runs. Omit for claude's own - /// default. The `base:claude-subagents` skill's "cheaper-than-you" - /// guidance still applies here. + /// Which model the subagent's own session runs (`--model`). Omit for + /// claude's own default. The `base:claude-subagents` skill's "Model + /// choice" guidance still applies here — pick the cheapest model that + /// can do the job, and don't be stingy about reaching for Haiku on a + /// well-scoped mechanical batch. #[serde(default)] model: Option, /// Which reasoning effort level the subagent's own session runs at @@ -55,7 +57,10 @@ struct StartArgs { /// models). Independent of `model`, so a cheap model at high effort or /// an expensive one at low effort are both valid combinations, not /// just the two extremes. See the `base:claude-subagents` skill for - /// Anthropic's own guidance on choosing between levels. + /// Anthropic's own guidance on choosing between levels. On Haiku with a + /// small context, effort up to `high` costs next to nothing, so there's + /// no cost reason to cap it at `medium`; at `max` it costs about what + /// Sonnet does on `low` (Sonnet's own default is `high`, a big price bump). #[serde(default)] effort: Option, /// Path to a file holding the subagent's actual task instructions. A