--- title: Claude Code Subagents: The Feature Everyone Has and... description: Claude Code ships with a subagents feature that lets developers define specialized agents as Markdown files in `.claude/agents/`. Each subagent has its own... canonical: https://daily.dev/posts/claude-code-subagents-the-feature-everyone-has-and-nobody-uses-right-fjzqfdefe twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: Claude Code Subagents: The Feature Everyone Has and Nobody Uses Right | daily.dev og:description: Claude Code ships with a subagents feature that lets developers define specialized agents as Markdown files in `.claude/agents/`. Each subagent has its own... og:url: https://daily.dev/posts/claude-code-subagents-the-feature-everyone-has-and-nobody-uses-right-fjzqfdefe og:image: https://api.daily.dev/og/posts/FJZQfDefe.png og:image:alt: Claude Code Subagents: The Feature Everyone Has and Nobody Uses Right og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # Claude Code Subagents: The Feature Everyone Has and Nobody Uses Right **[Noor Mohammad](https://daily.dev/sources/ew9hy5zthevyyefagop4g)** · [@noormohammad](https://daily.dev/noormohammad) · 1 min read · 0 upvotes · 1 comments ## Summary Claude Code ships with a subagents feature that lets developers define specialized agents as Markdown files in `.claude/agents/`. Each subagent has its own YAML frontmatter, system prompt, model, tool permissions, and isolated context — meaning it never inherits the parent conversation or files already read. Only the final report is returned, so all intermediate file reads and commands consume the subagent's tokens, not the main context. A practical pattern of three agents — scout, builder, and verifier — is introduced, along with context isolation rules and limitations that are poorly documented. ## Content Every Claude Code install ships with subagents, and almost nobody uses their own. A subagent is just a Markdown file in `.claude/agents/` — YAML frontmatter + a body that becomes its system prompt. Drop it in, picked up in seconds, no restart. Own model, own tool permissions, own memory, own clean context. The misunderstood part: it does NOT see your conversation or inherit files Claude already read. Fresh context + task briefing + your [CLAUDE.md](http://CLAUDE.md). Only the final report returns — every file read and command run stays in its context and **never costs yours a token.** Three files = scout, builder, verifier. Setup, the context rules nobody knows, and the limits the docs bury. 🔗 [https://medium.com/@reactjsbd/claude-code-subagents-the-feature-everyone-has-and-nobody-uses-right-3d64f56efec1?sharedUserId=reactjsbd](https://medium.com/@reactjsbd/claude-code-subagents-the-feature-everyone-has-and-nobody-uses-right-3d64f56efec1?sharedUserId=reactjsbd) ## Community discussion Top comments from developers on daily.dev. **@noormohammad** · 0 upvotes > The context-isolation economics are the real unlock — offload exploration to a subagent and your main window stays clean, which matters a lot if you're bumping the weekly cap. For anyone running custom agents: what's in your `.claude/agents/` folder, and did you hit the tool-permission or model-selection gotchas? ## Similar posts on daily.dev - [How and when to use subagents in Claude Code](https://daily.dev/posts/how-and-when-to-use-subagents-in-claude-code-j8ovmxhum) · Claude · 1 upvotes · 0 comments - [I ignored Claude Code's subagents until I realized what I was missing](https://daily.dev/posts/i-ignored-claude-code-s-subagents-until-i-realized-what-i-was-missing-cooyy1dqn) · XDA Developers · 1 upvotes · 0 comments - [I set up Claude Code the way Anthropic now recommends, and the sub-agents-spawning-sub-agents trick changed how I work](https://daily.dev/posts/i-set-up-claude-code-the-way-anthropic-now-recommends-and-the-sub-agents-spawning-sub-agents-trick--kltsswmr1) · XDA Developers · 0 upvotes · 0 comments --- Tags: [#ai-agents](https://daily.dev/tags/ai-agents), [#prompt-engineering](https://daily.dev/tags/prompt-engineering), [#claude-code](https://daily.dev/tags/claude-code), [#context-engineering](https://daily.dev/tags/context-engineering) [View this post on daily.dev](https://daily.dev/posts/claude-code-subagents-the-feature-everyone-has-and-nobody-uses-right-fjzqfdefe) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"DiscussionForumPosting","mainEntityOfPage":"https://daily.dev/posts/claude-code-subagents-the-feature-everyone-has-and-nobody-uses-right-fjzqfdefe","headline":"Claude Code Subagents: The Feature Everyone Has and Nobody Uses Right","text":"Claude Code ships with a subagents feature that lets developers define specialized agents as Markdown files in `.claude/agents/`. Each subagent has its own YAML frontmatter, system prompt, model, tool permissions, and isolated context — meaning it never inherits the parent conversation or files already read. Only the final report is returned, so all intermediate file reads and commands consume the subagent's tokens, not the main context. A practical pattern of three agents — scout, builder, and verifier — is introduced, along with context isolation rules and limitations that are poorly documented.","url":"https://daily.dev/posts/claude-code-subagents-the-feature-everyone-has-and-nobody-uses-right-fjzqfdefe","datePublished":"2026-08-02T07:48:33.642Z","dateModified":"2026-09-13T21:02:43.121Z","author":{"@type":"Person","name":"Noor Mohammad","url":"https://daily.dev/noormohammad","image":"https://media.daily.dev/image/upload/s--3w4n0n-6--/f_auto/v1754054115/avatars/avatar_eW9hy5zTHEVyYeFaGOP4G?_a=BAMClqZW0","description":"Software Engineer | React, Next.js & scalable web apps | Writing on AI, blockchain & emerging tech","interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"EndorseAction"},"userInteractionCount":180}},"image":"https://media.daily.dev/image/upload/s--lzdDIbsR--/f_auto/v1785656913/posts/FJZQfDefe?_a=BAMAMicg0","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":1}],"comment":[{"@type":"Comment","text":"The context-isolation economics are the real unlock — offload exploration to a subagent and your main window stays clean, which matters a lot if you’re bumping the weekly cap. For anyone running custom agents: what’s in your .claude/agents/ folder, and did you hit the tool-permission or model-selection gotchas?","datePublished":"2026-08-02T07:48:44.847Z","url":"https://daily.dev/posts/FJZQfDefe#c-MB9Kff5dB","author":{"@type":"Person","name":"Noor Mohammad","url":"https://daily.dev/noormohammad","image":"https://media.daily.dev/image/upload/s--3w4n0n-6--/f_auto/v1754054115/avatars/avatar_eW9hy5zTHEVyYeFaGOP4G?_a=BAMClqZW0"}}],"isPartOf":{"@type":"WebPage","url":"https://daily.dev/sources/ew9hy5zthevyyefagop4g","name":"Noor Mohammad"}} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Noor Mohammad","item":"https://daily.dev/sources/ew9hy5zthevyyefagop4g"},{"@type":"ListItem","position":3,"name":"Claude Code Subagents: The Feature Everyone Has and Nobody Uses Right"}]} ```