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.