feat(dx): document /tmp worktree isolation pattern for parallel agents

[bokelley]

Context

Multiple agents working in the same checkout clobber each other's branches. Observed during the comprehensive cycle: W2 left in-progress edits on W3's branch.

The git worktree add /tmp/<branch> -b <name> main pattern isolates work so parallel agents don't collide, but it isn't documented anywhere.

Acceptance Criteria

• Documentation section (in CLAUDE.md or contributor docs) describing the worktree isolation pattern
• Checklist for spawning parallel work
• Example invocation

Refs

• Observed clobber: W2 ↔ W3 collision during comprehensive cycle

[bokelley]

Triage

Classification: Feature request (documentation)
Bucket(s): docs
Status: drafting-pr
Milestone: omitted (no target version specified)

What the experts said:

• docs-expert: clear, well-scoped addition to CLAUDE.md; add cleanup instruction and note hooks are per-worktree — both nits, no blockers
• dx-expert: high-value agent-facing guidance; flagged unresolvable .env placeholder and missing CONDUCTOR.md cross-link as blockers — both fixed in the draft

My take: The branch-clobber failure is silent and expensive, and the worktree fix is a single command — documenting it in CLAUDE.md where every agent reads it before acting is the right call. Draft PR #428 covers all three acceptance criteria (pattern, checklist, example invocation).

Drafting PR: adds "Parallel Agent Isolation (git worktrees)" section to CLAUDE.md with create command, setup checklist (.env via git rev-parse --git-common-dir, pre-commit install, deps), teardown, branch-naming note, and pointer to CONDUCTOR.md.

---

Triaged by Claude Code. Session: https://claude.ai/code/session_017TUh8WYUoUWzdxDQMPLM5t

---

Generated by Claude Code