moai-workflow-worktree

Manage Git worktrees for isolated parallel SPEC development with automatic branch registration.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines parallel SPEC development by providing isolated Git worktrees, eliminating context-switching overhead and preventing conflicts.

Core Features & Use Cases

  • Isolated Workspaces: Each SPEC gets its own worktree with independent Git state.
  • Parallel Development: Work on multiple SPECs simultaneously without interference.
  • Seamless Integration: Integrates with MoAI-ADK workflow phases (Plan, Run, Sync).
  • Use Case: Develop features for a new authentication system and a payment gateway concurrently, each in its own isolated environment, then sync them independently.

Quick Start

Use the moai-workflow-worktree skill to create a new isolated 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 worktree for parallel feature development without switching branches?

Git worktree enables parallel feature development by creating isolated working directories tied to independent branches. This allows simultaneous SPEC development without context-switching overhead or branch state interference in your local environment.

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

Managing isolated workspaces for simultaneous SPEC development is best handled through automated Git worktree creation. This approach assigns each SPEC its own independent Git state and working directory, preventing conflicts during concurrent feature builds.

Can I use Git worktree with MoAI-ADK workflow automation phases?

Yes, Git worktree integrates seamlessly with MoAI-ADK workflow automation phases. It supports the Plan, Run, and Sync stages to automatically register isolated workspaces and synchronize parallel SPEC development branches independently.

Do I need MoAI-ADK integration to set up isolated Git worktrees for SPEC development?

MoAI-ADK integration is required for workflow automation when setting up isolated Git worktrees. While Git worktree functionality creates the isolated workspaces, MoAI-ADK manages the automated branch registration and workflow phase synchronization.

Why use isolated workspaces for concurrent authentication and payment gateway feature development?

Isolated workspaces prevent context-switching overhead and code conflicts when developing concurrent features like authentication and payment gateways. Each feature gets its own Git worktree, allowing independent development and synchronization without mutual interference.