gsd-new-workspace

Creates isolated Git worktrees or clones with planning directories for multi-repo tasks.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/nnexai/git-stacks --skill gsd-new-workspace-nnexai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-new-workspace
Source: https://github.com/nnexai/git-stacks/tree/main/.github/skills/gsd-new-workspace
Command: npx skills add https://github.com/nnexai/git-stacks --skill gsd-new-workspace-nnexai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the friction of manually setting up multi-repo environments and planning directories, ensuring each task has a clean, isolated workspace.

Core Features & Use Cases

  • Isolated Planning: Automatically creates a dedicated .planning/ directory for every new workspace to keep GSD sessions separate.
  • Flexible Orchestration: Supports both lightweight git worktrees and full clones to manage multiple repositories simultaneously.
  • Use Case: When starting a new feature that spans three different repositories, use this skill to create a single workspace folder that links all three repos and initializes the planning environment in one command.

Quick Start

Use the gsd-new-workspace skill to create a new workspace named feature-x with the default worktree strategy.

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 isolated git workspaces for multi-repo feature development?

To set up isolated git workspaces, use a workspace scaffolding tool that orchestrates git worktrees or clones and automatically initializes dedicated planning directories for task-scoped development.

What is the best way to manage planning directories across multiple git repositories?

Managing planning directories across multiple repositories relies on creating an isolated workspace that automatically generates a dedicated .planning/ folder, keeping task management sessions separate for each feature environment.

Can I use git worktrees instead of full clones to scaffold a new workspace?

Yes, workspace scaffolding supports both lightweight git worktrees and full clones, allowing you to orchestrate multiple repositories simultaneously and choose the strategy that best fits your isolation needs.

Do I need shell access to automate the creation of isolated development workspaces?

Yes, automating the creation of isolated development workspaces requires local shell access to execute initialization workflows and interact directly with your existing local git repositories.

How do I scaffold a workspace that links three separate repositories for a single feature?

Scaffolding a workspace that links multiple repositories involves running a single orchestration command that groups the target repos and initializes the planning environment within one isolated folder.

When should I avoid using automated workspace scaffolding for task management?

You should avoid automated workspace scaffolding if your projects lack local git repositories or if your environment restricts the execution of shell-based initialization workflows required for orchestration.