Claude Code subagents worth building

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

Works in

3
Claude Code subagents ideas
2.5k
upvotes on the source threads
6
Reddit threads
3
weekend-sized builds

Build time vs. demand

Bar length = upvotes on the Reddit threads behind each idea

3 Claude Code subagents ideas

Most upvoted first. Open a card for build steps and 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

The threads behind them

Most upvoted Reddit posts

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?

Test-first subagent: Writes a failing test that reproduces the bug before the main agent is allowed to fix it. It is sized at weekend, and the threads behind it have 1k upvotes.

More vibe coding ideas

By agent and by build type

Your next idea is already validated.

You just haven't seen it yet.