gsd-new-workspace

Creates isolated workspaces with git worktrees or clones and independent planning directories.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/jjchambers80/judgesdirectory --skill gsd-new-workspace-jjchambers80
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-new-workspace
Source: https://github.com/jjchambers80/judgesdirectory/tree/main/.github/skills/gsd-new-workspace
Command: npx skills add https://github.com/jjchambers80/judgesdirectory --skill gsd-new-workspace-jjchambers80

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working across multiple git repositories or feature branches often requires juggling shared state and conflicting planning data. This Skill creates an isolated workspace containing copies of selected repos with its own independent .planning/ directory, so parallel GSD sessions never interfere with each other. ## Core Features & Use Cases - Multi-repo orchestration: Select a subset of child git repos and assemble them into a single workspace directory for coordinated work. - Flexible isolation strategies: Choose lightweight git worktrees (default) or fully independent clones per repo. - Independent planning state: Each workspace gets its own .planning/ directory and a WORKSPACE.md manifest, keeping GSD session state isolated. - Use Case: You need to develop a feature spanning three repos without disturbing your main checkout. Run the command with --name feature-x --repos api,web,shared to get an isolated workspace, then cd in and run /gsd-new-project to start planning. ## Quick Start Ask the AI to create a new isolated workspace named "feature-x" containing the api and web repos using the default worktree strategy.

Frequently Asked Questions about gsd-new-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an isolated workspace for multiple git repos?▼

Run the command with --name for the workspace and --repos listing the repositories, for example --name feature-x --repos api,web. The workspace is created at ~/gsd-workspaces/<name> by default with each repo as a worktree and its own .planning/ directory.

What is the difference between worktree and clone strategy?▼

The worktree strategy is the default and creates lightweight git worktrees sharing the original repo's object store. The clone strategy creates fully independent repository copies, which is heavier but completely detached from the source repos.

Can I create a workspace non-interactively without prompts?▼

Yes, pass the --auto flag to skip interactive questions and use defaults for all options. Combine it with --name and --repos to fully specify the workspace in a single command.

What happens if I omit the --repos flag?▼

If --repos is omitted, the command interactively prompts you to select from child git repositories found in the current working directory. This lets you pick repos without typing their paths manually.

What should I do after creating the workspace?▼

After creation, cd into the workspace directory and run /gsd-new-project to initialize GSD with the workspace's independent .planning/ directory. The WORKSPACE.md manifest documents the workspace contents.