Subagent Builder & Orchestrator FAQs

Question 1

How do I launch the subagent builder?

Accepted Answer

You can launch the interactive builder by running the /agents command in your Claude Code terminal, which allows you to create, edit, or delete agent configurations.

Question 2

How does Claude choose which subagent to use?

Accepted Answer

Claude uses the natural language description provided in the subagent's YAML frontmatter to automatically route tasks to the most appropriate agent based on the context of your request.

Question 3

What is the difference between project-level and user-level subagents?

Accepted Answer

Project-level subagents are stored in the agents/ directory of a specific project and take priority, while user-level agents are stored in ~/agents/ and are available across all your projects.

Question 4

What is a Claude Code subagent?

Accepted Answer

A subagent is a specialized, isolated Claude instance with its own focused role, specific tool access, and unique system prompt, designed to perform tasks autonomously within a larger workflow.

Question 5

Can subagents interact with the user directly?

Accepted Answer

No, subagents are designed as 'black boxes.' They cannot use tools like AskUserQuestion and must complete their assigned tasks autonomously before returning the final output to the main conversation.

Subagent Builder & Orchestrator

Key Features

Use Cases

Subagent Builder & Orchestrator

Key Features

Use Cases