Skip to content

subagent-workflow SKILL.md doc-drift — sibling-dir example vs in-repo .claude/worktrees layout #345

Description

@julianken

Surface

.claude/skills/subagent-workflow/SKILL.md shows the worktree-add example as a sibling-directory path (git worktree add ../wt-330-login-form -b feat/login-form), but the actual enforced layout in this run is in-repo at .claude/worktrees/wt-NNN-<slug> (mandated for the harness sandbox; sibling-paths get rejected).

Why it matters

The bot review on PR #344 (review id 4230868695) flagged this as an IMPORTANT finding while reviewing W2.3 Code Agent. The PR's code-agent.ts correctly cites the actual .claude/worktrees/wt-NNN-<slug> layout — the gap is upstream in the SKILL.md doc.

Scope

Update the SKILL.md worktree example to use .claude/worktrees/wt-NNN-<slug>, with a note about the harness-sandbox requirement that forces in-repo paths.

Surfaced from

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions