docs(agents): document worktree/branch cleanup as part of PR close-out #76

Claude · 2026-07-05T13:36:48Z

Claude commented

2026-07-05 13:36:48 +00:00

Summary

Adds a bullet to the "Subagent orchestration" section of AGENTS.md treating worktree/branch cleanup as part of closing out a merged PR, not a separately-remembered step.
Documents the two mechanical gotchas from #75: git worktree remove --force --force (double -f) is needed once a worktree has initialized submodules to run tests, and git worktree remove never deletes either the feature branch or the Agent tool's auto-generated worktree-agent-<id> isolation branch — both need explicit git branch -d.

Fixes #75

Test plan

Pre-push hook test suite passed
Pre-commit hooks (secrets scan, conventional commit, etc.) passed

## Summary - Adds a bullet to the "Subagent orchestration" section of `AGENTS.md` treating worktree/branch cleanup as part of closing out a merged PR, not a separately-remembered step. - Documents the two mechanical gotchas from #75: `git worktree remove --force --force` (double `-f`) is needed once a worktree has initialized submodules to run tests, and `git worktree remove` never deletes either the feature branch or the `Agent` tool's auto-generated `worktree-agent-<id>` isolation branch — both need explicit `git branch -d`. Fixes #75 ## Test plan - [x] Pre-push hook test suite passed - [x] Pre-commit hooks (secrets scan, conventional commit, etc.) passed

Claude added 1 commit 2026-07-05 13:36:48 +00:00

docs(agents): document worktree/branch cleanup as part of PR close-out fcff7deb2c

Adds a bullet to the Subagent orchestration section in AGENTS.md so
coordinators treat merged-PR cleanup as one atomic step: verify the
merge, force-remove the worktree (double -f, since this repo's test
runs initialize submodules), and delete both the feature branch and
any Agent-tool-generated worktree-agent-<id> isolation branch.

Fixes #75

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FNJWdVvdgvZCHi1hZGqgVQ

Defame1297 requested review from Defame1297 2026-07-05 13:37:07 +00:00

Defame1297 approved these changes 2026-07-05 13:37:17 +00:00

Defame1297 merged commit 3b4763ece9 into main

2026-07-05 13:37:21 +00:00

Defame1297 deleted branch docs/75-worktree-branch-cleanup

2026-07-05 13:37:21 +00:00

Defame1297 referenced this issue from a commit

2026-07-05 13:37:22 +00:00

Merge pull request 'docs(agents): document worktree/branch cleanup as part of PR close-out' (#76) from docs/75-worktree-branch-cleanup into main

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Defame1297/holocron#76