docs(research): cross-worktree gitignored coord-doc sync — verdict ADAPT (symlink-to-canonical) - #78
Merged
Conversation
…APT (symlink-to-canonical) R-phase deliverable for the gitignored-coordination-doc drift problem (.claude/orchestrator-prompts/** per-worktree copies diverge on edit). Search-coverage executed: SSOT consult (no match; near-neighbours #27/#28/#44 rejected on problem-class), DeepWiki x3 (git/git, superpowers, git-worktree.nvim), WebSearch x3, internal sweep. 8 candidates enumerated across copy/symlink/hardlink/ relocate/un-gitignore semantics; per-candidate verdict via build-first-reuse-default §2 typology. Recommendation: ADAPT symlink-to-canonical (b)+(e) — proven by worktree-env-sync + worktree.linkFiles proposal; copy-at-creation tools (git-worktreeinclude/ git-worktree-runner) REFERENCE'd only (T-coord-A: name-match, wrong problem class — they copy, we need live sync). <=30 LOC harness-agnostic helper sketch. Zero LLM, no daemon, no CI surface. §1.7 forward+backward checks applied; T15 self-application surfaced the recursion that this R-phase's own kickoff was gitignored-absent from its fresh worktree. Prior-art: skipped — research-patch only, no new capability shipped (deliverable is one tracked markdown analysis file under docs/meta-factory/research-patches/).
This was referenced May 25, 2026
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
1 participant
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.
Summary
R-phase deliverable: a research-patch analysing the cross-worktree gitignored coordination-doc drift problem (
.claude/orchestrator-prompts/**is gitignored → each git worktree carries its own physical copy → an SSOT edit in one worktree leaves the other N−1 stale). Surveys 8 candidate mechanisms, applies the 7-verdict build-first-reuse typology, and lands on ADAPT — symlink-to-canonical (one canonical dir outside all worktrees, symlinked into each, so an edit is the same inode everywhere). No implementation; recommendation + ≤30 LOC bash sketch + maintainer ATTN items only.Changes
docs/meta-factory/research-patches/2026-05-17-cross-worktree-coord-doc-sync.md(+266 LOC, one tracked file).grepsweep — all command-verified.Prior-art consult
Prior-art:trailer — escape-hatch used:skipped — research-patch only, no new capability shipped(deliverable is one tracked markdown analysis file).Last reviewedtouch needed (no match).Test plan
docs/meta-factory/research-patches/); no code, no hooks, no principles touched.-ftest).§1.7 Self-discipline check (REQUIRED if PR touches discipline-bearing files)
§1.7 Skipped: research-patch deliverable only — recommends a future symlink mechanism, introduces no rule under .claude/rules or principles; the forward/backward discipline analysis lives inside the doc itself at §6 (forward) and §7 (backward) with per-line file:line citations.