[DOCS] Subagents documentation missing `isolation: "worktree"` configuration

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/sub-agents

Section/Topic

Subagent YAML frontmatter schema and subagent execution/isolation behavior.

Current Documentation

Supported frontmatter fields currently include:

name, description, tools, disallowedTools, model, permissionMode, maxTurns, skills, mcpServers, hooks, memory

The page also documents foreground/background execution, but no worktree isolation setting.

What's Wrong or Missing?

Claude Code v2.1.49 adds subagent support for isolation: "worktree" (temporary git worktree execution).

The subagents docs do not describe this setting, including:

• valid values,
• lifecycle/cleanup behavior,
• implications for file visibility and git state.

Suggested Improvement

Add isolation to supported frontmatter fields and document "worktree" behavior with:

1. YAML example,
2. lifecycle semantics (creation/cleanup),
3. safety and git workflow notes.

Impact

High - Prevents users from using a feature

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/sub-agents | 203-220 | Supported frontmatter fields omit isolation |
| https://code.claude.com/docs/en/sub-agents | 502-516 | Execution section discusses foreground/background only |

Total scope: 2 sections on 1 page affected