gsd-new-workspace

Create isolated git workspaces with worktrees, clones, and a .planning/ directory.

Updated Aug 15, 2025
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-new-workspace-gesmith0606
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-new-workspace
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/.claude/skills/gsd-new-workspace
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-new-workspace-gesmith0606

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating isolated development spaces that hold copies of multiple git repos with independent planning data, enabling parallel work without state leakage.

Core Features & Use Cases

  • Create a dedicated workspace directory with a manifest and planning area
  • Copy specified repos as worktrees or clones in the workspace
  • Interactive repo selection when repos are not provided
  • Optional per-repo branch handling and naming
  • Outputs a WORKSPACE.md manifest and a .planning/ directory for isolated GSD sessions

Quick Start

Run gsd-new-workspace with a name and optional repos to generate a new isolated workspace.

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 repositories?

You create an isolated workspace by generating a target directory containing copies of specified git repos as worktrees or clones, alongside an independent .planning/ directory for separate state management.

What is the benefit of using git worktrees for parallel feature development?

Git worktrees allow you to maintain separate branches in different directories without state leakage, enabling parallel workstreams across multiple repositories while keeping your planning data isolated in a dedicated .planning/ directory.

Can I specify individual branches for each repository in a multi-repo workspace?

Yes, when creating a multi-repo workspace, you can apply optional per-repo branch handling and naming to ensure each cloned repository or worktree checks out the correct branch for your feature isolation scenario.

How do I generate a manifest file for my development workspaces?

Generating a manifest file happens automatically when you create a new workspace, outputting a WORKSPACE.md file that records the included repositories, branches, and target paths for your isolated development environment.

Do I need to provide a list of repositories to set up a multi-repo workspace?

No, you do not need to provide a repository list upfront; if repos are not provided, the system supports interactive repo selection to help you choose which repositories to include as worktrees or clones in your workspace.

What is the best way to isolate GSD state for parallel workstreams?

The best way to isolate GSD state is to create a dedicated workspace directory with an independent .planning/ folder, preventing state leakage between parallel workstreams while managing multiple git repositories.