moai-workflow-worktree

Manages isolated Git worktrees for parallel SPEC development and MoAI-ADK workflow integration.

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

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 Git worktrees, preventing conflicts and context-switching overhead.

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: Develop a new user authentication feature and a payment processing module concurrently in separate worktrees, syncing and integrating them independently.

Quick Start

Create a new worktree for SPEC-AUTH-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 isolated Git worktrees for parallel feature development?

To manage isolated Git worktrees for parallel feature development, you can create separate workspaces for each SPEC. This allows concurrent work on multiple features with independent state, preventing context-switching overhead and conflicts.

What is the best way to work on multiple SPECs simultaneously without interference?

The best way to work on multiple SPECs simultaneously without interference is using isolated Git worktrees. Each SPEC receives its own worktree with an independent state, enabling parallel development without affecting the main branch.

Can I integrate Git worktree workflows with MoAI-ADK development phases?

Yes, you can integrate Git worktree workflows with MoAI-ADK. The system supports seamless integration with MoAI-ADK workflows, specifically /moai:1-plan, /moai:2-run, and /moai:3-sync commands.

Does parallel development with Git worktrees require manual branch registration?

Parallel development with Git worktrees does not require manual branch registration. The system supports automatic branch registration, streamlining the creation of isolated workspaces for concurrent SPEC development.

When should I use isolated workspaces for feature branch isolation?

You should use isolated workspaces for feature branch isolation when developing independent modules concurrently. This approach prevents context-switching overhead and keeps the state of features like user authentication and payment processing separate until integration.

Why use separate Git worktrees for code review workflows?

Using separate Git worktrees for code review workflows provides an isolated environment to examine feature branches independently. This prevents conflicts with ongoing development and maintains a clean state for reviewing specific SPEC implementations.