[Bug] Documentation: additionalDirectories incorrectly stated as non-propagating to Task subagents

Resolved 💬 3 comments Opened Dec 27, 2025 by 0xnfrith Closed Feb 14, 2026

Bug Description
[Automated Bug Detection System]

DOCUMENTATION INACCURACY: Subagent Permission Inheritance

## Issue
The Claude Code documentation incorrectly states that additionalDirectories do NOT propagate to subagents spawned via the Task tool. Testing confirms this is FALSE — /add-dir permissions DO propagate to Task-spawned subagents.

## Faulty Documentation Sources

## What the docs claim
"additionalDirectories are parent-session-only. Subagents spawned via the Task tool do not inherit these expanded permissions."

## Actual behavior (tested 2025-12-27)

  1. Run /add-dir /path/to/external-repo in parent session
  2. Spawn 6 parallel Task subagents targeting that path
  3. Result: ALL subagents successfully accessed the external path (Glob, Grep, Read, Bash all worked)

## Impact
Developers designing multi-agent skills may incorrectly believe cross-directory scanning is impossible, leading to unnecessary architectural workarounds.

## Suggested fix
Update documentation to clarify that /add-dir (session-level additionalDirectories) DOES propagate to Task-spawned subagents.

Environment Info

  • Platform: darwin
  • Terminal: ghostty
  • Version: 2.0.76
  • Feedback ID: 34a223e5-7650-4053-97c9-937bf509f98d

Errors

[]

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗