moai-workflow-worktree

Manages Git worktrees for parallel SPEC development with automatic branch registration and MoAI-ADK integration.

Updated Feb 19, 2026
One-click install
npx skills add https://github.com/taewook486/real-estate-mcp --skill moai-workflow-worktree-taewook486
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moai-workflow-worktree
Source: https://github.com/taewook486/real-estate-mcp/tree/main/.claude/skills/moai-workflow-worktree
Command: npx skills add https://github.com/taewook486/real-estate-mcp --skill moai-workflow-worktree-taewook486

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines parallel software development by providing isolated, self-contained 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 phases (Plan, Run, Sync).
  • Use Case: A developer needs to work on three different features (User Auth, Payment Gateway, Dashboard) concurrently. This Skill allows them to create separate, isolated worktrees for each, enabling parallel development and reducing merge conflicts.

Quick Start

Use the moai-worktree skill to create a new isolated 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 use Git worktrees for parallel development on multiple features?

Git worktrees enable parallel development by creating isolated workspaces for each SPEC. This Skill automates worktree management, assigning independent branches to different features so you can work simultaneously without context switching or merge conflicts.

What is an isolated workspace in Git and when do I need it for SPEC management?

An isolated workspace is a self-contained Git worktree with independent state for a specific SPEC. You need it when developing multiple features concurrently, as it eliminates interference between branches and streamlines context switching.

How do I create an isolated worktree for a new feature SPEC?

To create an isolated worktree, invoke the worktree creation command with a SPEC identifier and description. The Skill automatically registers a new Git branch and sets up the isolated workspace integrated with MoAI-ADK workflow phases.

Does parallel development with Git worktrees work with MoAI-ADK workflow integration?

Yes, parallel development using Git worktrees seamlessly integrates with MoAI-ADK workflow phases including Plan, Run, and Sync. This ensures your isolated SPEC workspaces remain synchronized with the broader automated workflow automation pipeline.

What is the best way to prevent merge conflicts when working on multiple SPECs simultaneously?

The best way to prevent conflicts during simultaneous feature work is using isolated Git worktrees. This Skill provides each SPEC with a self-contained workspace, eliminating context-switching overhead and preventing branch interference.