docs(adcp): document git worktree isolation pattern for parallel agents#428
Merged
docs(adcp): document git worktree isolation pattern for parallel agents#428
Conversation
…AUDE.md Documents the git worktree pattern for parallel agent isolation, including spawn checklist, .env and pre-commit setup steps, teardown, and branch naming convention. Closes #418. https://claude.ai/code/session_017TUh8WYUoUWzdxDQMPLM5t
Addresses pre-PR review blockers: replace unresolvable /path/to/repo-root placeholder with git rev-parse --git-common-dir to reliably locate the main worktree root, and add CONDUCTOR.md cross-reference. https://claude.ai/code/session_017TUh8WYUoUWzdxDQMPLM5t
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #418
Adds a "Parallel Agent Isolation (git worktrees)" section to
CLAUDE.mddocumenting thegit worktree add /tmp/<branch>pattern that prevents parallel agents from clobbering each other's branches. The section covers: why isolation is needed (silent branch collision), the create command with the correctclaude/issue-<N>-<slug>branch naming, a setup checklist (.envcopy viagit rev-parse --git-common-dir,pre-commit install,pip install -e .[dev]), teardown, and a pointer toCONDUCTOR.mdfor Conductor-managed worktrees.What was tested:
CLAUDE.md); no Python source touched — build/pytest gate skipped per triage-prompt rule for markdown-only diffsgit rev-parse --git-common-dirverified to resolve to main worktree.gitdir in linked-worktree contextgit worktree add <path> -b <branch> <commit>confirmed valid per man page)Pre-PR review:
cpcould note missing-file case (cosmetic)cdin checklist is redundant with the "run inside the new worktree" label (cosmetic)Session: https://claude.ai/code/session_017TUh8WYUoUWzdxDQMPLM5t
Generated by Claude Code