docs: jj workspaces live inside the repo under .workspaces - #20
Open
runewright[bot] wants to merge 1 commit into
Open
docs: jj workspaces live inside the repo under .workspaces#20runewright[bot] wants to merge 1 commit into
runewright[bot] wants to merge 1 commit into
Conversation
![macroscopeapp[bot]](https://avatars.githubusercontent.com/in/900172?s=60&v=4){kind=small}
| ## Parallel agents | ||
|
|
||
| Multiple agents editing one working copy still collide at the file level; jj only removes the index collision. Give each agent its own working copy sharing one store: `jj workspace add ../repo-agent-1` creates an isolated directory and `@` backed by the same history and op log. This is the jj-native replacement for the git-worktree lifecycle (no manual create / rebase / remove / delete-branch). Companions: `jj workspace list`, `jj workspace forget`. | ||
| Multiple agents editing one working copy still collide at the file level; jj only removes the index collision. Give each agent its own working copy sharing one store: `jj workspace add .workspaces/agent-1` creates an isolated directory and `@` backed by the same history and op log. Workspaces live in `.workspaces/<name>` inside the repo, ignored by `.gitignore`; sibling directories (`../repo-<name>`) pollute the parent directory and break IDE workspace paths. This is the jj-native replacement for the git-worktree lifecycle (no manual create / rebase / remove / delete-branch). Companions: `jj workspace list`, `jj workspace forget`. |
There was a problem hiding this comment.
🟠 High JujutsuToolkit/SKILL.md:35
The guidance states that .workspaces/<name> is ignored by .gitignore, but the repository's .gitignore has no .workspaces/ entry — it only ignores .worktrees/. Running jj workspace add .workspaces/agent-1 therefore creates a nested working copy that is not excluded from the outer workspace, so the parent @ can snapshot the inner workspace's files and contaminate the parent change with unrelated agent edits. Either add .workspaces/ to .gitignore before recommending this layout, or remove the claim that the directory is already ignored.
🚀 Reply "fix it for me" or copy this AI Prompt for your agent:
In file @skills/JujutsuToolkit/SKILL.md around line 35:
The guidance states that `.workspaces/<name>` is ignored by `.gitignore`, but the repository's `.gitignore` has no `.workspaces/` entry — it only ignores `.worktrees/`. Running `jj workspace add .workspaces/agent-1` therefore creates a nested working copy that is not excluded from the outer workspace, so the parent `@` can snapshot the inner workspace's files and contaminate the parent change with unrelated agent edits. Either add `.workspaces/` to `.gitignore` before recommending this layout, or remove the claim that the directory is already ignored.
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.
The JujutsuToolkit skill places parallel-work workspaces inside the repository under
.workspaces/<name>.Plan
The skill's workspace guidance matches the GitWorktrees rule: in-repo
.workspaces/<name>, not sibling directories, so agents and humans find and clean them the same way.Changes
skills/JujutsuToolkit/SKILL.md: workspace creation examples and guidance use.workspaces/<name>inside the repository.Testing
Note
Update jj workspace path guidance to use
.workspaces/<name>inside the repoUpdates SKILL.md to recommend placing workspaces under
.workspaces/<name>inside the repo rather than as sibling directories (e.g.,../repo-<name>). The new guidance explains that.workspaces/is covered by.gitignoreand that sibling directories can pollute the parent directory and break IDE workspace paths.📊 Macroscope summarized f268d9e. 1 file reviewed, 0 issues evaluated, 0 issues filtered, 0 comments posted
🗂️ Filtered Issues
No issues evaluated.