moai-workflow-worktree

Manage Git worktrees for parallel SPEC development with isolated workspaces.

Updated Feb 2, 2026
One-click install
npx skills add https://github.com/CJ-1981/excel-processor --skill moai-workflow-worktree-cj-1981
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moai-workflow-worktree
Source: https://github.com/CJ-1981/excel-processor/tree/main/.claude/skills/moai-workflow-worktree
Command: npx skills add https://github.com/CJ-1981/excel-processor --skill moai-workflow-worktree-cj-1981

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines parallel software development by creating isolated, manageable Git worktrees for each SPEC, preventing conflicts and context-switching overhead.

Core Features & Use Cases

  • Isolated Workspaces: Each SPEC gets its own independent Git environment.
  • 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 a new authentication feature (SPEC-A) and a payment integration (SPEC-B) concurrently. This Skill allows them to create separate worktrees for each, develop them in parallel, and sync them independently before merging.

Quick Start

Use the moai-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 use Git worktrees for parallel development on multiple features?

Git worktrees enable parallel development by creating isolated workspaces for each feature. This Skill manages worktree creation and automatic branch registration, allowing you to develop multiple SPECs simultaneously without interference or context-switching overhead.

What is the best way to manage isolated workspaces for SPEC development?

Managing isolated workspaces for SPEC development requires assigning an independent Git environment to each feature. This Skill creates separate worktrees with seamless integration into MoAI-ADK workflow phases, preventing branch conflicts during concurrent development.

Do I need MoAI-ADK CLI tools to automate Git worktree creation?

Yes, Git worktree functionality and MoAI-ADK CLI tools are required for operation. The Skill relies on these CLI tools to facilitate seamless integration with workflow phases like Plan, Run, and Sync for independent branch management.

Can I sync multiple Git worktrees independently before merging?

Yes, you can sync multiple Git worktrees independently. The Skill integrates with the Sync workflow phase, allowing you to manage and synchronize isolated workspaces for concurrent SPECs like authentication and payment features before final merging.

How does automatic branch registration work with Git worktrees?

Automatic branch registration assigns and tracks independent Git states when a worktree is created for a SPEC. This prevents manual branch management errors and ensures each isolated workspace maintains its own separate version control state.

Why use isolated Git worktrees instead of standard branches for concurrent features?

Isolated Git worktrees provide independent directories for each SPEC, eliminating the context-switching overhead of standard branches. This allows simultaneous development of multiple features, like authentication and payment integration, without file conflicts.