Shayan Rais
be2ad50e32
Settings report (claude-settings.md): - Add autoConnectIde, autoInstallIdeExtension, showClearContextOnPlanAccept to ~/.claude.json table - Re-add unverified annotation on allow_remote_sessions (official docs say not a settings key) - Add source:'settings' marketplace type to Plugin Settings with inline example - Add rate_limits fields to Status Line Input Fields table - Bump version badge and header to v2.1.81 Other reports: bump badges to v2.1.81, update development workflow stars and counts Co-Authored-By: Claude <noreply@anthropic.com>
3.8 KiB
3.8 KiB
Sub-agents Best Practice
Claude Code subagents — frontmatter fields and official built-in agent types.
| ← Back to Claude Code Best Practice |  |
Frontmatter Fields (15)
| Field | Type | Required | Description |
|---|---|---|---|
name |
string | Yes | Unique identifier using lowercase letters and hyphens |
description |
string | Yes | When to invoke. Use "PROACTIVELY" for auto-invocation by Claude |
tools |
string/list | No | Comma-separated allowlist of tools (e.g., Read, Write, Edit, Bash). Inherits all tools if omitted. Supports Agent(agent_type) syntax to restrict spawnable subagents; the older Task(agent_type) alias still works |
disallowedTools |
string/list | No | Tools to deny, removed from inherited or specified list |
model |
string | No | Model alias: haiku, sonnet, opus, or inherit (default: inherit) |
permissionMode |
string | No | Permission mode: default, acceptEdits, dontAsk, bypassPermissions, or plan |
maxTurns |
integer | No | Maximum number of agentic turns before the subagent stops |
skills |
list | No | Skill names to preload into agent context at startup (full content injected, not just made available) |
mcpServers |
list | No | MCP servers for this subagent — server name strings or inline {name: config} objects |
hooks |
object | No | Lifecycle hooks scoped to this subagent. All hook events are supported; PreToolUse, PostToolUse, and Stop are the most common |
memory |
string | No | Persistent memory scope: user, project, or local |
background |
boolean | No | Set to true to always run as a background task (default: false) |
effort |
string | No | Effort level override when this subagent is active: low, medium, high, max. Default: inherits from session |
isolation |
string | No | Set to "worktree" to run in a temporary git worktree (auto-cleaned if no changes) |
color |
string | No | CLI output color for visual distinction (e.g., green, magenta). Functional but absent from official frontmatter table — documented in interactive quickstart only |
(6)
| # | Agent | Model | Tools | Description |
|---|---|---|---|---|
| 1 | general-purpose |
inherit | All | Complex multi-step tasks — the default agent type for research, code search, and autonomous work |
| 2 | Explore |
haiku | Read-only (no Write, Edit) | Fast codebase search and exploration — optimized for finding files, searching code, and answering codebase questions |
| 3 | Plan |
inherit | Read-only (no Write, Edit) | Pre-planning research in plan mode — explores the codebase and designs implementation approaches before writing code |
| 4 | Bash |
inherit | Bash | Running terminal commands in a separate context |
| 5 | statusline-setup |
sonnet | Read, Edit | Configures the user's Claude Code status line setting |
| 6 | claude-code-guide |
haiku | Glob, Grep, Read, WebFetch, WebSearch | Answers questions about Claude Code features, Agent SDK, and Claude API |