gsd-new-workspace

Creates an isolated workspace directory with git worktrees or clones for multiple repositories.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/hadpadrahul/school-erp --skill gsd-new-workspace-hadpadrahul
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-new-workspace
Source: https://github.com/hadpadrahul/school-erp/tree/main/.codex/skills/gsd-new-workspace
Command: npx skills add https://github.com/hadpadrahul/school-erp --skill gsd-new-workspace-hadpadrahul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating isolated development workspaces that securely host multiple repos with independent planning areas, reducing cross-repo interference and setup time.

Core Features & Use Cases

  • Multi-repo orchestration: Clone or graft multiple repositories as separate workspaces to enable parallel development.
  • Isolated planning space: Each workspace gets its own .planning/ directory for GSD sessions, ensuring clean state between tasks.
  • Flexible setup: Choose worktree or full clone strategies, specify a target path, and automatically initialize workflows for rapid start.

Quick Start

Initialize a new workspace named <name> with specified repos, using the worktree strategy, in path <path> with an independent .planning/ directory.

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 repos?▼

To create an isolated workspace for multiple git repos, use this Skill to orchestrate multi-repo orchestration by generating copies of specified repositories using either worktree or clone strategies. It outputs a workspace manifest and an independent .planning directory.

What is the difference between worktree and clone strategies for multi-repo orchestration?▼

For multi-repo orchestration, the worktree strategy grafts branches from existing local repositories to enable feature-branch isolation, while the clone strategy creates full standalone copies. Both generate an isolated workspace directory with independent planning state.

Does setting up a multi-repo workspace require specific flags or paths?▼

Setting up a multi-repo workspace requires specifying flags including --name, --repos, --path, --strategy, and --branch. You can also use the --auto flag to automatically initialize workflows for rapid setup in your target directory.

Why use an isolated planning directory when working across multiple repositories?▼

An isolated planning directory ensures clean GSD state between tasks by securely hosting independent planning areas for each workspace. This reduces cross-repo interference and setup time during parallel development across multiple repositories.

Can I automate feature-branch isolation for parallel development?▼

You can automate feature-branch isolation by using the --auto flag with the worktree strategy. This automatically initializes the isolated workspace and planning directory, enabling rapid parallel development across specified git repositories.