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.