gsd-new-workspace

Create isolated git workspaces with per-repo directories and .planning/ folders.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically creates isolated workspaces by duplicating selected git repositories into independent directories, each with its own .planning/ workspace.

Core Features & Use Cases

  • Orchestrate multiple repos in parallel within a single workspace
  • Choose between lightweight worktrees or full clones for each repo
  • Provide an isolated .planning/ directory to store per-workspace artifacts and state

Quick Start

Create a new workspace named <name> and specify repos using --repos <list> to bootstrap the environment.

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

You can create isolated workspaces by specifying a workspace name and a list of git repositories. The process duplicates the repositories into independent directories and generates a dedicated .planning/ folder for per-workspace artifacts and state.

What is the best way to manage planning artifacts across multiple git repositories?

An isolated workspace provides a dedicated .planning/ directory to store per-workspace artifacts and state. This ensures planning data remains separate from the individual repository structures while orchestrating multiple repos in parallel.

Can I use git worktrees instead of full clones when setting up a multi-repo workspace?

Yes, you can choose between lightweight git worktrees or full clones for each repository in the workspace. This strategy parameter allows you to optimize disk space and branching workflows according to your experimentation needs.

How do I automate the creation of a workspace with a specific git branch and repository list?

You can automate workspace creation by using parameters for name, repos, path, strategy, branch, and auto mode. This enables automatic bootstrapping of the environment without manual directory setup or manual repository duplication.

When should I use an isolated workspace for my git repositories?

You should use an isolated workspace for multi-repo development and experimentation workflows where each environment requires separate repositories and a dedicated planning space. This prevents state conflicts when running parallel feature branches or tests across multiple repos.