moai-workflow-worktree

Creates Git worktrees for isolated, parallel development of multiple projects.

Updated Dec 14, 2025
One-click install
npx skills add https://github.com/seo-jinseok/regulation_manager --skill moai-workflow-worktree-seo-jinseok
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moai-workflow-worktree
Source: https://github.com/seo-jinseok/regulation_manager/tree/main/.claude/skills/moai-workflow-worktree
Command: npx skills add https://github.com/seo-jinseok/regulation_manager --skill moai-workflow-worktree-seo-jinseok

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and modules (resource) components.

What problem does it solve?

This Skill streamlines parallel software development by creating isolated, independent workspaces for each SPEC, eliminating context-switching overhead and preventing conflicts.

Core Features & Use Cases

  • Isolated Workspaces: Each SPEC gets its own Git worktree with independent state.
  • Parallel Development: Work on multiple SPECs simultaneously without interference.
  • Seamless Integration: Integrates with MoAI-ADK workflow (/moai:1-plan, /moai:2-run, /moai:3-sync).
  • Use Case: A developer needs to work on a new feature (SPEC-A) while also addressing a critical bug fix (SPEC-B). This Skill allows them to create separate worktrees for each, develop in isolation, and sync changes independently.

Quick Start

Use the moai-workflow-worktree skill to create a new worktree for SPEC-001 with the description 'User Authentication'.

Frequently Asked Questions about moai-workflow-worktree

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage parallel feature development without context switching in Git?

Isolated workspaces for parallel SPEC development prevent context switching by assigning each feature its own Git worktree with independent state. This eliminates branch conflicts and allows developers to work on multiple features simultaneously without interference.

How do I create an isolated workspace for a specific feature spec?

You create an isolated SPEC workspace by generating a new Git worktree with a specific SPEC identifier and description. This automatically registers an independent branch to develop the feature without affecting the main workspace.

Do I need MoAI-ADK to use parallel worktree workflows?

Yes, MoAI-ADK integration is required for parallel worktree workflows. The skill leverages the MoAI-ADK command-line interface to execute sequential workflow commands like /moai:1-plan, /moai:2-run, and /moai:3-sync.

What is the best way to sync changes from isolated feature worktrees?

The best way to sync changes from isolated feature worktrees is using the /moai:3-sync command. This integrates the independent worktree state back into the main workflow seamlessly after parallel SPEC development is complete.

Can I work on a bug fix and a new feature simultaneously using Git worktrees?

Yes, you can work on a bug fix and a new feature simultaneously by creating separate Git worktrees for each SPEC. This allows you to develop in isolation and sync changes independently without branch interference.

When should I avoid using Git worktrees for parallel development?

You should avoid using Git worktrees for parallel development if your project lacks Git worktree functionality or does not integrate with the MoAI-ADK command-line interface, as both are required for automated branch registration and syncing.