Skip to content

docs: declare the sibling worktree directory for agent sessions - #63

Merged
BunsDev merged 1 commit into
mainfrom
docs/worktree-directory
Oct 11, 2026
Merged

BunsDev merged 1 commit into
mainfrom
docs/worktree-directory

Conversation

@BunsDev

@BunsDev BunsDev commented Oct 11, 2026

Copy link
Copy Markdown
Contributor

What changed

Adds a short CLAUDE.md that points to AGENTS.md and declares the repo's existing worktree convention: siblings of the checkout at ../jev-harness-wt/<name>.

Why: agent worktree skills (e.g. superpowers using-git-worktrees) look for a worktree-directory preference in CLAUDE.md before falling back to a global path. Without one, six jev-harness worktrees landed under ~/.config/superpowers/worktrees/jev-harness/ (branches ui/header-github-link, feat/next-demo-foundation, feat/routing-contract, dev/arena-main-20260922, docs/routing-live-evaluation, review/pr27-archive), outside every sandboxed session's reach, so they could be listed but never inspected or retired. Declaring the convention keeps new worktrees reachable. No source, config, fixture, or dependency is touched.

Verdict impact

None. Documentation only; no fixture or verdict changes.

Verification

  • pnpm typecheck — not run: Markdown-only change, no TypeScript touched; CI runs it
  • pnpm test — not run: Markdown-only change; CI runs it
  • Commits are signed (git log -1 --show-signature: Good "git" signature, ED25519)
  • No provider call, credential, execution path, or new verdict added
  • Decision table and questions unchanged; no architecture/README/test update needed

🤖 Generated with Claude Code

Agent worktree skills look for a worktree-directory preference in CLAUDE.md
before falling back to a global path. Without one, six jev-harness worktrees
landed under ~/.config/superpowers/worktrees, outside every sandboxed session's
reach, and could be listed but never retired. State the existing
../jev-harness-wt/ convention so new worktrees stay reachable.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 11, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
jev-harness Ready Ready Preview Oct 11, 2026 8:07am UTC

Request Review

@BunsDev
BunsDev merged commit e5bdbab into main Oct 11, 2026
3 checks passed
@BunsDev
BunsDev deleted the docs/worktree-directory branch October 11, 2026 13:57

This branch was successfully deployed

1 active deployment
Preview — 398633a2 Deployed Oct 11, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant