Claude Code subagents worth building

Subagents are separate Claude instances with their own prompt, tools and context window.

Looking for ones that already exist? See Claude Code setup on aistack.sh, our directory of tested AI tool stacks.

Works in

Claude Code logoClaude Code
7
Claude Code subagents ideas
8.8k
upvotes on the source threads
12
Reddit threads
5
weekend-sized builds

Build time vs. demand

Bar length = upvotes on the Reddit threads behind each idea

Weekend5 ideas
1 to 2 weeks2 ideas

7 Claude Code subagents ideas

Most upvoted first. Open a card for build steps and threads

▲ 2k
2 Reddit threads
Subagent

Cheap reader subagent

Runs file reading and log digging on a cheaper model and hands the main session a short summary.

Claude Code logoWeekendFree, builds an audience
How to build it
  1. 1Define a subagent on a smaller model with read and search tools only.
  2. 2Route file searches, log reads and doc lookups to it from CLAUDE.md.
  3. 3Publish token counts before and after to show the saving.
.claude/agentsSmaller model settingRead and search tools onlyBuyer: Max and API users watching cost

The Reddit threads

▲ 2k
1 Reddit thread
Subagent

Overbuild reviewer

Reviews the finished diff and cuts wrappers, extra classes and code the standard library already covers.

Claude Code logoWeekendFree, paid language packs
How to build it
  1. 1Ask of each new block: does it need to exist, and does the standard library or a current dependency do it.
  2. 2Have the subagent return a shorter diff, not a list of comments.
  3. 3Call it at the end of every task from CLAUDE.md.
.claude/agentsgit diffRules per languageBuyer: Developers tired of bloated agent code

The Reddit threads

▲ 1.8k
2 Reddit threads
Subagent

Locked-down subagents

Subagent templates with tight tool lists, no nested spawning and a check on what they hand back.

Claude Code logo1 to 2 weeksFree, $10/mo teams
How to build it
  1. 1Ship subagent files that list only the tools each job needs and cannot start other subagents.
  2. 2Use a SubagentStop hook to flag results that tell the main session to delete or run something.
  3. 3Sell shared policies so a team's subagents follow the same limits.
.claude/agentsSubagentStop hookTool allowlistsBuyer: Teams running many subagents at once

The Reddit threads

▲ 1k
2 Reddit threads
Subagent

Test-first subagent

Writes a failing test that reproduces the bug before the main agent is allowed to fix it.

Claude Code logoWeekendFree, paid framework packs
How to build it
  1. 1Define a subagent that may only touch test files.
  2. 2Have it reproduce the bug as a failing test and hand back the test name.
  3. 3Use a Stop hook to confirm the test passes before the task closes.
.claude/agentsTest runnerStop hookBuyer: Vibe coders whose fixes keep breaking things

The Reddit threads

▲ 850
2 Reddit threads
Subagent

Codebase scout

A read-only subagent that maps the repo and returns only the files that matter to the task.

Claude Code logoWeekendFree, builds an audience
How to build it
  1. 1Give the subagent read and search tools only.
  2. 2Cache a repo map so repeat searches are cheap.
  3. 3Return a short list of files and why each matters.
.claude/agentsripgrepRepo map cacheBuyer: Developers working in large repos

The Reddit threads

▲ 589
2 Reddit threads
Subagent

Adversarial reviewer

A subagent whose only job is to break the main agent's diff before you merge it.

Claude Code logoWeekendFree, paid rule packs
How to build it
  1. 1Define a read-only subagent prompted to find bugs, not to praise.
  2. 2Hand it the staged diff plus the original task.
  3. 3Block the commit until each finding is fixed or waived.
.claude/agentsgit diffTest runnerBuyer: Solo devs shipping agent-written code

The Reddit threads

▲ 556
1 Reddit thread
Subagent

Session waste auditor

Reads your past session logs and shows where the tokens went: repeat reads, retries and bloated output.

Claude Code logo1 to 2 weeks$19 one-time report
How to build it
  1. 1Point the subagent at the last 30 days of local session logs.
  2. 2Rank waste by pattern: files read twice, failed commands, oversized tool output.
  3. 3Suggest a CLAUDE.md or settings change for each pattern.
.claude/agentsSession JSONL logsMarkdown reportBuyer: Heavy users hitting weekly limits

The Reddit threads

The threads behind them

Most upvoted Reddit posts

2k
upvotes
I gave Claude Code a "lazy senior dev" mode and it writes like 6x less code
r/ClaudeCode · 187 comments · Jun 2026
→ Overbuild reviewer
1.8k
upvotes
Claude subagent got bored and prompt injected my main session into deleting my database
r/ClaudeAI · 223 comments · Aug 2026
→ Locked-down subagents
1.4k
upvotes
Anthropic just benchmarked "Fable 5 orchestrates, cheap models execute": 96% of the performance at 46% of the cost. You can run this pattern in Claude Code today
r/ClaudeAI · 237 comments · Jul 2026
→ Cheap reader subagent
842
upvotes
I saved 10M tokens (89%) on my Claude Code sessions with a CLI proxy
r/ClaudeAI · 188 comments · Feb 2026
→ Codebase scout

BID MCP server

Ask your agent what to build next

Connect Business Ideas Database to Claude Code, Codex or Cursor and search validated ideas, Reddit proof and keyword data without leaving the terminal.

# Claude Code
❯ claude mcp add --transport http bid \
https://businessideasdb.com/api/mcp \
--header "Authorization: Bearer $BID_KEY"
✓ Connected: search_ideas, get_idea
# then just ask
❯ find me a dev tool idea with real demand

Questions

What are Claude Code subagents?

Subagents are separate Claude instances defined in Markdown files under .claude/agents, each with its own system prompt, allowed tools and context window. The main session hands them a task and gets back only the result, which keeps its own context clean.

When is a subagent better than a skill?

When the work is long or noisy, like searching a large codebase, reviewing a diff or running a test suite. The subagent spends its own context on the details and returns a short summary.

What is the easiest Claude Code subagents idea to start with?

Cheap reader subagent: Runs file reading and log digging on a cheaper model and hands the main session a short summary. It is sized at weekend, and the threads behind it have 2k upvotes.

More vibe coding ideas

By agent and by build type

All ideas53 ideasClaude Code52 ideasCodex30 ideasCursor19 ideasChatGPT apps6 ideasClaude Code skills8 ideasClaude Code hooks7 ideasClaude Code plugins7 ideasMCP servers8 ideas

Your next idea is already validated.

You just haven't seen it yet.