[DOCS] Permissions docs omit repository-root storage for always-allow rules in git worktrees

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/permissions

Section/Topic

"Manage permissions" and "Project allow rules and workspace trust", plus cross-reference from the worktrees guide.

Current Documentation

The permissions page explains /permissions and that allow rules can live in project or local settings files:

You can view and manage Claude Code's tool permissions with /permissions. This UI lists all permission rules and the settings.json file each rule comes from.

Workspace trust is keyed to the git repository root:

Claude Code saves trust per workspace, keyed on the git repository root or, outside a repository, the directory you started Claude Code from.

Neither section states where interactive "always allow" approvals are written when the session runs in a linked git worktree, or that those approvals now persist across worktrees and sessions at the repository root.

What's Wrong or Missing?

Claude Code v2.1.211 changed "always allow" permission rules to save at the repository root so approvals granted in a git worktree persist across sessions and worktrees. Developers using claude --worktree expect allow rules to follow the repository, not only the worktree checkout path. The worktrees guide does not mention permission persistence either.

Suggested Improvement

In permissions.md, add a subsection under "Manage permissions":

When you choose always allow on a permission prompt, Claude Code saves the allow rule at the git repository root (not only in the current worktree directory). The same rule applies in other worktrees and future sessions for that repository. Requires Claude Code v2.1.211 or later.

Add a short cross-link from worktrees.md in "Start Claude in a worktree" pointing to this behavior.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/permissions | 27–33, 472–489 | /permissions UI and workspace trust |
| https://code.claude.com/docs/en/worktrees | 15–47 | Parallel sessions with --worktree |

Total scope: 2 pages affected

Version: v2.1.211 behavior change.