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.