openspec-sp-git-worktree

What problem does it solve?

Creates isolated, reproducible working directories for branch-specific development to prevent workspace contamination, accidental commits of ephemeral files, and environment drift.

Core Features & Use Cases

• Safe directory selection and policy: Prioritizes existing worktrees directories, project preferences, or explicit user choice.
• Safety validation: Verifies git ignore status and updates .gitignore when necessary to avoid accidental commits.
• Worktree creation and setup: Creates named branches in dedicated worktrees, runs project setup commands, and verifies baseline tests for feature development, bugfixes, or experiments.
• Use Case: Spin up a feature branch worktree, run dependency installation, and confirm tests before starting implementation.

Quick Start

Create an isolated worktree at worktrees/feature-auth on a new branch feature/auth, ensure the directory is git-ignored, run the project setup commands for the repository, and execute baseline tests to confirm the environment is ready.