Skip to content
Concept

subagents

subagents — Concept. definition: Delegated agents with their own separate context window · usage: Parallel Claude instances challenging each other for code review

Anthropic's Claude Code documentation, published 2025-09-29, defines subagents as delegated agents that each run in their own separate context window, with a configurable tool set and a custom system prompt of their own. The delegation is what matters here: the main conversation stays on the high-level objective while the intermediate output stays somewhere else.

Thariq, an engineer at Anthropic, frames subagents as one of five options a user has at the end of a turn, alongside continuing, rewind, `/clear` and `/compact`. His test for when to reach for one is a question about the output rather than the task: will I need this output, or only the conclusion? Verifying a result, reading another codebase, writing documentation. All of them generate volume that the main session never has to carry.

The second use is adversarial. «Boris Cherny» spawns several subagents for code review that challenge each other: a first pass on style guidelines, project history and obvious bugs, then five more poking holes in the original findings. At Every, the assess step of «Compound Engineering» runs twelve parallel subagents scoring the same code on security, performance, complexity and architecture, and Every has released that workflow as an open source plugin for «Claude Code».

The documentation lists chaining several subagents for complex workflows, and dynamic selection where Claude picks the appropriate one from the task description. Thariq expects these mechanisms to eventually be handled automatically. For now, deciding when to delegate remains the user's judgement.

Type
Concept
definition
Delegated agents with their own separate context window
usage
Parallel Claude instances challenging each other for code review
relations
14
Cited in
2 fiches

Neighborhood

Claude Code répertoire .claude/a… context window séparé Sid Bidasaria fichiers Markdown YA… Boris Cherny Compound Engineering préservation du cont… Contexte propre isolé MCP Tools chaînage de workflows agentId Opus 4.5

← uses

Claude Code TECHNOLOGIE high confidence evolving Source ↗
Boris Cherny PERSONNE high confidence evolving Source ↗
Compound Engineering METHODOLOGIE high confidence evolving Source ↗

← enables

Claude Code TECHNOLOGIE high confidence timeless Source ↗

→ observed in

répertoire .claude/agents/ TECHNOLOGIE high confidence stable Source ↗

→ uses

context window séparé CONCEPT high confidence timeless Source ↗
fichiers Markdown YAML frontmatter TECHNOLOGIE high confidence stable Source ↗
MCP Tools TECHNOLOGIE high confidence evolving Source ↗
agentId CONCEPT high confidence stable Source ↗

← created

Sid Bidasaria PERSONNE high confidence stable Source ↗

→ improves

préservation du contexte CONCEPT high confidence timeless Source ↗

→ enables

Contexte propre isolé CONCEPT high confidence timeless Source ↗
chaînage de workflows CONCEPT high confidence timeless Source ↗

← applies to

Opus 4.5 TECHNOLOGIE high confidence evolving Source ↗

Cited in (2)