← Back to all entries
2026-06-28 ✅ Best Practices

Sub-Agents vs. One Long Session: Choosing the Right Shape

Sub-Agents vs. One Long Session: Choosing the Right Shape — visual for 2026-06-28

When a Sub-Agent Earns Its Complexity — and When It Doesn't

Sub-agents are easy to reach for once they're available, but they're not free — each one adds a coordination boundary that has to be designed and later audited. A useful rule of thumb: spin up a sub-agent when a piece of work is genuinely independent (its output doesn't need the parent's evolving context to make sense) and when keeping its exploration out of the main conversation protects context budget for the parts of the task that do need it.

The single-session default is still correct most of the time

For most day-to-day work, a single well-scoped session outperforms a sub-agent architecture in both speed and simplicity. Reach for sub-agents when you can articulate specifically what context isolation buys you — not as a default pattern for anything that feels "big."

⭐⭐⭐ code.claude.com
sub-agents Claude Code context isolation workflow design context budget

Naming and Scoping Sub-Agents So You Can Actually Audit Them Later

When a session has spawned several sub-agents, the difference between a five-minute audit and a confusing archaeology exercise usually comes down to naming discipline set up front. A sub-agent named descriptively for its actual task ("audit-auth-middleware", "migrate-user-schema") is trivially greppable later; a generic default name isn't.

A simple naming convention worth adopting

Name sub-agents with a verb-object pattern that describes the deliverable, not the mechanism: research-x, fix-y, audit-z — rather than agent-1, helper, or worker. Six months from now, when you're trying to reconstruct what a session actually did, descriptive names in a log are the difference between reconstructing intent in seconds versus re-reading full transcripts.

⭐⭐⭐ code.claude.com
sub-agents naming conventions auditability Claude Code
Source trust ratings ⭐⭐⭐ Official Anthropic  ·  ⭐⭐ Established press  ·  Community / research