gsd-new-workspace

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

Updated Aug 15, 2025

Search Tags:#automation #git #devops #worktree #workspace #multi-repo #clone

Ready to run

npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-new-workspace-gesmith0606

💬 Prompt for ChatGPT / Claude Chat▼

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.