gsd-new-workspace

Create isolated git workspaces with separate repos and planning directories.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of setting up a clean, isolated workspace for one or more git repositories, so you can start parallel work without state collisions or shared planning files.

Core Features & Use Cases

  • Workspace Creation: Builds a dedicated workspace directory with its own manifest and independent planning state.
  • Repo Isolation: Creates each selected repository as a worktree or clone, depending on how much separation you need.
  • Multi-Repo Orchestration: Useful when you need to coordinate changes across several repos while keeping planning and execution scoped to one workspace.
  • Feature Branch Setup: Ideal for spinning up a branch-specific environment that stays detached from your main local setup.

Quick Start

Use the gsd-new-workspace skill to create a new isolated workspace named sprint-alpha from the selected repositories using the default settings.

Frequently Asked Questions about gsd-new-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up an isolated git workspace for multi-repo orchestration?

To set up an isolated git workspace, you need to generate a workspace manifest, select target repositories, provision worktrees or clones, assign branches, and pass validation gates for safe handoff. This creates separated state and workspace boundaries for parallel sessions.

What is the best way to isolate feature branches across multiple git repositories?

The best way to isolate feature branches across multiple git repositories is to create a dedicated workspace directory with its own independent planning state, using worktrees or clones to detach branch-specific environments from your main local setup and prevent state collisions.

When do I need a separate workspace directory with independent planning state?

You need a separate workspace directory with independent planning state when running parallel GSD sessions that require multi-repo orchestration. It prevents shared planning file conflicts and keeps execution scoped strictly to one isolated workspace boundary.

Does workspace provisioning use git worktrees or clones for repo isolation?

Workspace provisioning uses both git worktrees and clones for repo isolation. The choice depends on how much separation you need: worktrees share underlying object databases for lightweight branching, while clones create entirely separate repository copies for complete detachment.

Can I coordinate changes across several repos while keeping planning scoped to one workspace?

Yes, you can coordinate changes across several repos while keeping planning scoped to one workspace. The workspace creation process builds a dedicated directory with its own manifest, ensuring multi-repo orchestration remains isolated without affecting your main local setup.