Skip to content

Add delegation-threshold and model-inheritance rules to subagent-orchestration - #3

Merged
assert-not-singularity merged 2 commits into
mainfrom
feat-delegate-only-with-reason
Sep 19, 2026
Merged

assert-not-singularity merged 2 commits into
mainfrom
feat-delegate-only-with-reason

Conversation

@assert-not-singularity

@assert-not-singularity assert-not-singularity commented Sep 19, 2026 •

Copy link
Copy Markdown
Owner

Why

In a long session with a large agent fleet, most of the spend came from three things the skill either didn't address or stated too softly. Subagents were spawned to verify claims against a handful of PRs and issues — lookups a grep answers. 13 of 23 subagents in one stretch were spawned by other subagents, all inheriting the orchestrator's top-tier model because none set one; the existing "state the reason for a larger model" rule never triggered, since nobody chose the model. And every subagent started at ~100K tokens because a spawn that names no tool list inherits every tool the parent has, MCP servers included — the skill described the cost but not that inheriting everything is the default.

What changed

In plugin/templates/skills/subagent-orchestration/SKILL.md:

  • New opening section, Don't delegate what a command answers: before spawning, ask whether a grep, one command, or reading one file answers it; delegate only for a reason you can name (context isolation, genuine parallelism, a fresh perspective).
  • Under Right-size the model and effort: set the model explicitly on every spawn — an unset model inherits the parent's, and a nested spawn inherits that again, so one top-tier orchestrator silently makes its whole subtree top-tier.
  • Under Restrict each subagent's tools: the default is the failure — no tool list means every tool inherited — so name the few tools the task needs on every spawn (a web-research agent needs fetch and search, not a GitHub or Slack MCP).

No version bump here: #2 already bumps 0.3.0 → 0.4.0, and both land before any project runs /preflight:update.

🤖 Generated with Claude Code

…estration

Don't spawn a subagent for what a grep or one command answers; delegate
only for a reason you can name. Set the model explicitly on every spawn,
since an unset model inherits the parent's down the whole spawn tree.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
A spawn that names no tool list inherits every tool the parent has, MCP
servers included — so the ~100K baseline is the default outcome, not a
rare mistake. Name the few tools a task needs on every spawn.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

No unresolved review issues were identified.

Review effort: Lite
Findings: None

What changed in this PR

Adds cost-control guidance for subagent delegation, model selection, and tool inheritance.

Changes:

  • Discourages delegating tasks answerable by simple commands.
  • Requires explicit model selection for every spawn.
  • Requires explicitly restricting each subagent’s tools.
File Description
plugin/​templates/​skills/​subagent-orchestration/​SKILL.md Adds delegation, model-inheritance, and tool-inheritance guidance.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@assert-not-singularity
assert-not-singularity merged commit acf8fca into main Sep 19, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants