~/VibeHandbook
$39

Agent Tooling

docs.claude.com

Subagents

What it is

Think of a manager who hands a focused task to a temporary assistant: the assistant does it, reports back the result, then leaves. A subagent is that temporary assistant — a separate AI that your main agent can spawn to handle a focused piece of work. It runs in its own context (its own separate workspace and memory) with its own instructions, does the job, and reports back a result. Because each subagent starts fresh, the main conversation stays clean — the details of a side task don't crowd out the work you actually care about.

Strengths

  • Keeps the main context uncluttered by offloading detail-heavy side tasks.
  • Lets you run independent work in parallel, which can be much faster.
  • Each subagent can be specialized — a reviewer, a searcher, a tester — with its own focused .
  • Failures stay contained: a subagent that goes wrong doesn't derail the whole .

Trade-offs

  • A subagent only knows what you pass it; missing context leads to off-target results.
  • Spawning many agents costs more tokens (the chunks of text models read and bill by) and can get expensive.
  • You only get the summary back, so nuance from the side task can be lost.
  • Coordinating several at once adds its own complexity.

When to use it

Use subagents when a task is self-contained and would otherwise bloat the main thread — searching a large codebase, reviewing a diff, or running several independent investigations at the same time.

Vibe coding fit

Subagents are how you scale an agent's attention. Hand the noisy, exploratory work — "find everywhere this is used," "review this for bugs" — to a subagent and keep the main agent focused on the plan. Be explicit about what each subagent should return, since you get its conclusion, not its full transcript.

Spawn a review subagent:
  task: "Review the diff in src/auth for security issues."
  return: "A short list of concrete problems, or 'no issues found'."