backlog(B-0751): per-agent isolated clones architecture — primary checkout is SHARED VIEW + FOR HUMAN; agents NEVER touch it#5019
Closed
AceHack wants to merge 1 commit into
Conversation
…ckout is SHARED VIEW + FOR HUMAN; agents NEVER touch it (Aaron 2026-05-25 architectural decision) Aaron 2026-05-25: 'yall can all have your own clones' + 'this one is shared view and for human'. Architectural shift from shared-.git/+multi-worktree to per-agent isolated clones. Eliminates the cross-agent contention class entirely. Primary checkout (/Users/acehack/Documents/src/repos/Zeta) = SHARED HUMAN VIEW; operator + co-owners use it for git status/log/diff/ checkout main. Agents NEVER touch it. Each agent gets own .git/+working tree at /private/tmp/zeta-clones/ <agent-identity>/ (e.g., otto-vscode/ alexa-kiro/ riven-cursor/ etc.) Supersedes B-0750's worktree-pool primitive scope item for cross-agent contention; B-0750's other scope items (cleanup tooling; checkout-path protection; main-hold detector) remain valuable WITHIN any clone. 6 scope items: init-tooling / fetch-sync discipline / agent invocation routing / operator-checkout-protection enforcement / disk+sync resource tracking / migration runbook. Composes with B-0750 (sibling rule; per-clone-internal still applies) + B-0747 (per-agent-clone IS per-agent state in machine-state declaration) + B-0741 (local-dev analog of fork primitive) + B-0727 (agent autonomy expression). P2 priority — high reuse-leverage; addresses recurring operator pain at architectural level. Not P1 because B-0750 rule operates today; becomes P1 if recurrence happens before per-agent-clone tooling ships. Co-Authored-By: Claude <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Adds a new P2 backlog row for a per-agent isolated clone architecture, positioning the primary checkout as a human-only shared view and replacing cross-agent shared-.git/ worktree contention with isolated clones.
Changes:
- Adds backlog item B-0751 with scope, migration, enforcement, and composition notes.
- Adds B-0751 to the generated backlog index.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
docs/backlog/P2/B-0751-per-agent-isolated-clones-architecture-primary-checkout-is-shared-human-view-agents-never-touch-aaron-2026-05-25.md |
New backlog row describing the isolated-clone architecture and related scope items. |
docs/BACKLOG.md |
Adds B-0751 to the P2 backlog index. |
Comment on lines
+12
to
+14
| - B-0750 | ||
| - B-0747 | ||
| - B-0741 |
| - B-0727 | ||
| - B-0530 | ||
| related_substrate: | ||
| - .claude/rules/agent-worktree-hygiene-never-hold-main-never-step-on-operator-cleanup-on-pr-merge.md |
| └── ... ← future agents | ||
| ``` | ||
|
|
||
| Each clone: |
|
|
||
| ## Composes with .claude/rules/ | ||
|
|
||
| - `.claude/rules/agent-worktree-hygiene-never-hold-main-never-step-on-operator-cleanup-on-pr-merge.md` (B-0750 rule) — still applies WITHIN any single clone; cross-clone is solved by isolation |
Member
Author
|
Closing as substrate-stale (DIRTY-conflict) per .claude/rules/pr-triage-tiers.md Tier 3 + the discriminator pass below. Discriminator pass:
Disposition: close. The branch content is preserved in git history; re-land path is cherry-pick onto a fresh branch off current main with any ID-collision renumbering needed. This is the same Tier 3 disposition applied to today's #5038 + #5032 (same root cause: 2026-05-25 evening session left ~9 backlog/rule PRs DIRTY when the next morning's iter-5.x + iter-6 work landed and moved main forward). This close is NOT a punt — it's explicit ownership classification per .claude/rules/fighting-past-self-vs-peer-agent-distinguisher-fix-your-own-coordinate-on-peers-dont-punt-by-default.md (recurrence anchor landed today via #5126). The substrate-honest re-land path is documented; the operator-tax of indeterminate DIRTY state is cleared. |
auto-merge was automatically disabled
May 26, 2026 08:07
Pull request was closed
AceHack
pushed a commit
that referenced
this pull request
May 27, 2026
Copilot flagged two references to B-0751 (per-agent isolated clones architecture) that aren't resolvable in-tree — PR #5019 (the proposed landing) was closed without merging, and no B-0751-* backlog row exists. Replace both references with concrete artifacts that DO exist: - PR #5019 (the closed design proposal) - B-0750 (worktree-hygiene row in tree) - .claude/rules/agent-worktree-hygiene-... rule path Composes with Lior's prior markdownlint fix (bce0e7e). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
AceHack
added a commit
that referenced
this pull request
May 27, 2026
* fix: Fix markdownlint errors in drift report * fix(PR #5514): replace B-0751 refs per Copilot review Copilot flagged two references to B-0751 (per-agent isolated clones architecture) that aren't resolvable in-tree — PR #5019 (the proposed landing) was closed without merging, and no B-0751-* backlog row exists. Replace both references with concrete artifacts that DO exist: - PR #5019 (the closed design proposal) - B-0750 (worktree-hygiene row in tree) - .claude/rules/agent-worktree-hygiene-... rule path Composes with Lior's prior markdownlint fix (bce0e7e). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> --------- Co-authored-by: Lior <lior@zeta.dev> Co-authored-by: Claude <noreply@anthropic.com>
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
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.
Aaron 2026-05-25 architectural decision: 'yall can all have your own clones' + 'this one is shared view and for human'. Eliminates cross-agent contention class entirely. Supersedes B-0750 worktree-pool primitive for cross-agent scope. 6 scope items. Composes with B-0750/B-0747/B-0741/B-0727/B-0530.
🤖 Generated with Claude Code