What problem does it solve? In a multi-worktree git setup, running ls or find on the outer repo's path shows whatever branch that working tree happens to be on — not main. Handoff docs and PR bodies that cite files as "on main" based on those listings ship fabricated claims that fail reviewer dead-reference checks. The same frame inversion makes git diff/git status run after a cd to the base repo show a different branch's working tree, making your own changes appear to vanish. ## Core Features & Use Cases - Ref-exact verification: Replace outer-repo ls/find with git ls-tree origin/main, git show origin/main:<path>, and git log --all to check whether a file truly exists on main. - Pre-PR citation audit: A grep-driven loop that extracts every cited path from a handoff doc or PR body and checks each against origin/main, flagging anything missing before push. - Wrong-cwd diagnosis: Discipline for the v1.1 variant — run git from your worktree (or git -C <worktree>), never cd to the base repo, and confirm with git rev-parse --show-toplevel before concluding a parallel session reverted your work. - Use Case: Before merging a handoff doc that claims "session_184 prompt is on main, unconsumed", run the citation audit, discover the file lives only in a sibling worktree, and rewrite the claim before review catches it. ## Quick Start Ask the agent to verify whether a specific file exists on origin/main using git ls-tree instead of listing the outer repo directory.
