moai-workflow-worktree

Create isolated Git worktrees for parallel SPEC development with MoAI-ADK integration.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/skeeper75/widget.creator --skill moai-workflow-worktree-skeeper75
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: moai-workflow-worktree
Source: https://github.com/skeeper75/widget.creator/tree/main/.claude/skills/moai-workflow-worktree
Command: npx skills add https://github.com/skeeper75/widget.creator --skill moai-workflow-worktree-skeeper75

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, 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 Plan-Run-Sync workflow.
  • Use Case: A developer needs to work on three different SPECs concurrently. They create a separate worktree for each SPEC, allowing them to switch between them instantly and develop in isolation.

Quick Start

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 where each SPEC gets an independent directory and branch state, eliminating context-switching overhead and preventing conflicts.

What is the best way to isolate SPEC development workspaces without switching branches?▼

Creating isolated Git worktrees for SPEC development allows developers to work on multiple features simultaneously in separate directories, avoiding the need to constantly switch branches or stash changes.

How do I set up an isolated workspace for a new SPEC in Git?▼

Setting up an isolated SPEC workspace involves creating a new Git worktree with automatic branch registration, providing an independent working directory specifically tailored for that feature's development.

Does parallel SPEC development work with MoAI-ADK workflow integration?▼

Parallel SPEC development integrates seamlessly with the MoAI-ADK Plan-Run-Sync workflow, requiring both Git worktree functionality and MoAI-ADK integration to maintain synchronized isolated workspaces.

Why use isolated worktrees instead of cloning multiple repositories for feature branch isolation?▼

Isolated worktrees provide feature branch isolation within a single repository, eliminating the storage overhead and sync complexities of multiple clones while allowing instant switching between parallel SPEC workspaces.

Can I manage multiple SPEC workspaces simultaneously without Git branch conflicts?▼

Managing multiple SPEC workspaces simultaneously is supported through isolated Git worktrees, which maintain independent branch states that prevent conflicts and interference during parallel development.