create-subagent

# Create Subagent

Create a specialized AI subagent that runs in its own context window with custom system prompt, tool access, and permissions. Subagents preserve main conversation context by handling complex tasks independently.

## Quick Start

```bash
# Interactive mode - guided creation
/create-subagent

# Auto mode - create from name
/create-subagent code-reviewer
```

## Subagent Locations

| Location | Path | Scope | Priority |
|----------|------|-------|----------|
| Project | `.claude/agents/<name>.md` | This project | Higher |
| User | `~/.claude/agents/<name>.md` | All projects | Lower |

Project-level subagents override user-level when names conflict.

## Creation Process

### 1. Determine Mode

- **With argument** (`$ARGUMENTS`): Auto mode - generate from name and recent workflow
- **Without argument**: Interactive mode - ask guided questions

### 2. Interactive Mode Questions

Use AskUserQuestion with these prompts:

**Question 1 - Role**:
- Header: "Role"
- Question: "What specialized role should this subagent fulfill?"
- Options:
  - "Code quality expert" - Review, refactor, improve code
  - "Testing specialist" - Write and run tests
  - "Architecture advisor" - Design systems, plan structure
  - "Domain expert" - Specialized domain knowledge

**Question 2 - Activation**:
- Header: "Activation"
- Question: "When should Claude delegate to this subagent?"
- Options:
  - "After code changes" - Proactively review new code
  - "Specific keywords" - Trigger on certain terms
  - "Explicit request only" - Only when user asks
  - "High-volume operations" - Isolate verbose output

**Question 3 - Tools** (multiSelect: true):
- Header: "Tools"
- Question: "Which tools should this subagent access?"
- Options:
  - "Read-only" - Read, Grep, Glob (safe exploration)
  - "File operations" - Read, Write, Edit, Glob
  - "Shell commands" - Bash execution
  - "All tools" - Inherit everything

**Question 4 - Model**:
- Header: "Model"
- Question: "Which model should power