moai-workflow-worktree

Manage Git worktrees for isolated parallel SPEC development in MoAI-ADK workflows.

67|27|Updated Dec 24, 2025
One-click install
npx skills add https://github.com/modu-ai/cc-plugins --skill moai-workflow-worktree-modu-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moai-workflow-worktree
Source: https://github.com/modu-ai/cc-plugins/tree/main/.claude/skills/moai-workflow-worktree
Command: npx skills add https://github.com/modu-ai/cc-plugins --skill moai-workflow-worktree-modu-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines parallel SPEC development by providing isolated workspaces, 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.
  • MoAI-ADK Integration: Seamlessly integrates with the Plan-Run-Sync workflow.
  • Use Case: Develop a new authentication module and a payment processing module concurrently, switching between them instantly without losing context or risking merge conflicts.

Quick Start

Use the moai-workflow-worktree skill to create a new worktree for SPEC-001.

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 feature development?

Git worktrees create isolated development environments, allowing you to develop multiple SPEC features simultaneously without interference or context-switching overhead. This Skill manages worktree creation and synchronization seamlessly within the MoAI-ADK workflow.

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

The best way to prevent merge conflicts during parallel SPEC development is using isolated workspaces. This Skill assigns each SPEC its own Git worktree with an independent state, eliminating context-switching overhead and preventing branch conflicts.

Do I need Git worktree functionality to run parallel SPEC development?

Yes, Git worktree functionality is required to run parallel SPEC development. This Skill relies on Git worktrees to provide each SPEC with an independent state and isolated testing environment within the project management workflow.

How does isolated testing work with Git worktrees?

Isolated testing with Git worktrees works by giving each SPEC its own independent directory state. This allows you to run tests for parallel features simultaneously without interference, switching between modules instantly without losing context.