gsd-new-workspace

Create isolated multi-repo workspaces with WORKSPACE.md manifests and .planning directories.

264|11|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/rkz91/coco --skill gsd-new-workspace-rkz91
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-new-workspace
Source: https://github.com/rkz91/coco/tree/main/systems/gsd/skills/gsd-new-workspace
Command: npx skills add https://github.com/rkz91/coco --skill gsd-new-workspace-rkz91

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create isolated workspaces that replicate multiple git repos with independent planning areas, enabling safe parallel development and experimentation without cross-repo interference.

Core Features & Use Cases

  • Multi-repo orchestration: spawn isolated workspaces containing copies of specified repos as either git worktrees or clones, each with its own state.
  • Independent planning environment: establish a dedicated .planning directory per workspace to hold planning data and decisions.
  • Workspace manifest: generate a WORKSPACE.md documenting the workspace configuration and included repos for future reference.

Quick Start

Provide a workspace name and optional repos, then run the gsd-new-workspace workflow to initialize the 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 isolated multi-repo workspaces for parallel development?

To create isolated multi-repo workspaces, you provide a workspace name and optional repositories to spin up an environment containing copies of repos as git worktrees or clones, each with independent state to prevent cross-repo interference during parallel development.

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

Managing independent planning data across multiple git repositories requires a dedicated .planning directory within each isolated workspace, ensuring workspace-specific state and planning decisions are kept separate from other parallel development efforts.

How do git worktrees compare to clones for multi-repo orchestration?

For multi-repo orchestration, git worktrees and clones serve as selectable strategies to replicate repositories within a workspace. Both provide independent state, but the chosen strategy dictates how the isolated workspace is structured and entered.

Can I document included repositories and configuration when spinning up a new workspace?

Yes, you can document included repositories and configuration when spinning up a new workspace. The process automatically generates a WORKSPACE.md manifest detailing the workspace configuration and repos for future reference.

Do I need any dependencies to set up multi-repo git worktree environments?

No external dependencies are required to set up multi-repo git worktree environments. You simply provide a workspace name and optional repos, then run the workflow to initialize the isolated workspace with its dedicated .planning directory.

When should I use isolated workspaces for multi-repo orchestration?

You should use isolated workspaces for multi-repo orchestration when teams need parallel development across repositories safely. This approach prevents cross-repo interference by maintaining workspace-specific state and independent planning areas for experimentation.