gsd-new-workspace

Create isolated multi-repo workspaces with independent .planning directories.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/MINT-IA/MINT --skill gsd-new-workspace-mint-ia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-new-workspace
Source: https://github.com/MINT-IA/MINT/tree/main/.claude/skills/gsd-new-workspace
Command: npx skills add https://github.com/MINT-IA/MINT --skill gsd-new-workspace-mint-ia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Create an isolated workspace with repo copies and an independent .planning/ directory for isolated GSD sessions.

Core Features & Use Cases

  • Multi-repo orchestration: work on a subset of repos in parallel with isolated GSD state.
  • Feature branch isolation: create a worktree or clone for each repo with its own planning context.
  • Use Case: Imagine you need to work on 3 repos concurrently; this creates an isolated workspace per project with separate planning data.

Quick Start

Run gsd-new-workspace --name <name> to create a new isolated workspace and then cd into it to begin work.

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 multi-repo development?▼

Yes, you can manage parallel work across multiple repositories by creating an isolated workspace. It sets up a worktree or clone for each repo with its own planning context, enabling you to work on a subset of repos concurrently without interfering with other project states.

What is the best way to isolate planning data for concurrent feature branches?▼

The best way to isolate planning data for concurrent feature branches is to generate a workspace with an independent .planning directory. This ensures that each project subset maintains its own isolated GSD state, keeping planning sessions separate across your repositories.

How do I set up a new workspace with specific Git repositories and a branch strategy?▼

You can set up a new workspace by running the command with flags like --repos to specify your Git repositories and --branch to define the target branch. Additional flags like --path and --strategy allow you to customize the clone or reference behavior for your project.

Does multi-repo workspace automation support generating a manifest file?▼

Yes, multi-repo workspace automation supports generating a manifest file. When you create the workspace, it automatically generates a WORKSPACE.md manifest alongside the per-repo work areas, documenting the configuration and structure of your isolated development environment.

When should I not use an isolated workspace for repo management?▼

You should not use an isolated workspace for repo management if your task involves working on a single repository or does not require isolated planning sessions. It is specifically designed for multi-repo orchestration and parallel work where independent GSD state and separate planning data are necessary.