gsd-new-workspace

Create isolated git workspaces with per-workspace planning directories and repo copies.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create isolated, self-contained git workspaces by duplicating specified repos and providing an independent .planning/ directory, enabling isolated GSD sessions and reduced cross-repo interference.

Core Features & Use Cases

  • Create a dedicated workspace directory containing copies of selected repos as either worktrees or clones.
  • Provide an isolated .planning/ directory for deterministic planning and workflow state.
  • Supports interactive prompting or auto mode, and easy switching to the workspace with a subsequent /gsd-new-project initialization.

Quick Start

Create a new workspace by specifying a name and a list of repos to generate a dedicated directory with copies and an isolated .planning/ folder.

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 isolated git workspaces for multi-repo development?

You can create an isolated git workspace by specifying a name and a list of target repositories. The workspace is generated with either git worktree or clone strategies, providing an independent .planning/ directory for deterministic workflow state and reduced cross-repo interference.

What is the difference between using git worktree and clone strategies for workspace isolation?

The worktree strategy links the isolated workspace to the existing local repository history, while the clone strategy creates a fully independent copy. Both approaches generate a dedicated directory with an isolated .planning/ folder to prevent cross-repo interference during development.

How do I automate the setup of multiple git repositories with independent planning directories?

You can automate multi-repo workspace setup by using the auto mode flag along with specifying the workspace name and target repositories. This automatically orchestrates the creation of isolated repo copies and the independent .planning/ directory without interactive prompting.

Do I need git installed to isolate workspaces with per-workspace planning directories?

Yes, git is required to isolate workspaces, as the process relies on git worktree or clone strategies to duplicate specified repos. You must have git available in your environment to execute the workspace orchestration and generate the planning directories.

Can I specify a custom branch when creating an isolated git workspace?

Yes, you can specify a custom branch using the branch flag when generating the workspace. This ensures the duplicated repos within the isolated workspace check out the correct branch before you initialize the independent planning directory.