Skip to content

docs: jj workspaces live inside the repo under .workspaces - #86

Open
runewright[bot] wants to merge 1 commit into
mainfrom
change/worktree-rule
Open

docs: jj workspaces live inside the repo under .workspaces#86
runewright[bot] wants to merge 1 commit into
mainfrom
change/worktree-rule

Conversation

@runewright

@runewright runewright Bot commented Aug 4, 2026

Copy link
Copy Markdown

jj workspaces for parallel work live inside the repository under .workspaces/<name>.

Plan

Sibling-directory workspaces pollute the parent directory and break IDE workspace paths; the in-repo location keeps them discoverable and cleanable. The rule states the location and the cleanup command.

Changes

  • Worktree rule rules/GitWorktrees.md: jj workspaces are created at .workspaces/<name> inside the repository, never as sibling directories.

Testing

  • Push-gate prek checks green

Note

Update jj workspace guidance to place workspaces inside the repo under .workspaces/

Updates GitWorktrees.md to recommend jj workspace add .workspaces/<name> instead of jj workspace add ../<name> for jj-colocated repos.

  • Adds a note that .workspaces/ should be added to .gitignore before creating the first workspace
  • Adds rationale that sibling directories pollute the parent directory and can break IDE workspace paths

Macroscope summarized dbce9a4.

@runewright
runewright Bot requested a review from N4M3Z as a code owner August 4, 2026 09:36
@github-actions github-actions Bot added the rules label Aug 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants