moai-workflow-worktree

Create isolated Git worktrees with central registry for parallel SPEC development.

1|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/GoosLab/moai-rank --skill moai-workflow-worktree-gooslab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moai-workflow-worktree
Source: https://github.com/GoosLab/moai-rank/tree/main/.claude/skills/moai-workflow-worktree
Command: npx skills add https://github.com/GoosLab/moai-rank --skill moai-workflow-worktree-gooslab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables teams to develop multiple SPECs in parallel by provisioning isolated Git worktrees and central registration, eliminating context-switching and merge conflicts.

Core Features & Use Cases

  • Isolated Workspaces: Each SPEC runs in its own worktree with independent Git state and environment.
  • Automatic Registration & Tracking: Worktrees are registered in a central registry for visibility and automation.
  • MoAI-ADK Workflow Integration: Seamless Plan-Run-Sync lifecycle guidance for SPEC development.
  • Use Case: A developer can work on SPEC-AUTH-001 in one window and SPEC-PAY-001 in another without interference.

Quick Start

Plan a SPEC with /moai:1-plan to automatically create an isolated worktree and begin development.

Frequently Asked Questions about moai-workflow-worktree

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run parallel SPEC development tasks without Git merge conflicts?

Provision isolated Git worktrees for parallel SPEC development to maintain independent Git states and environments, eliminating context-switching and merge conflicts. Each SPEC operates in its own dedicated directory for safe concurrent work.

How do I start an isolated worktree for a new SPEC?

Start isolated worktree development by planning a SPEC with the /moai:1-plan command, which automatically creates an isolated worktree and begins the integrated Plan-Run-Sync lifecycle guidance for your workflow.

Does MoAI-ADK support worktree-aware development patterns for concurrent work?

MoAI-ADK supports worktree-aware development patterns by providing seamless Plan-Run-Sync lifecycle guidance and automatic worktree registration in a central registry, ensuring scalable parallel work across multiple SPECs.

Can I track all active isolated worktrees in a central registry?

Yes, you can track all active isolated worktrees using a central registry that provides automatic registration and visibility for all provisioned environments. This central tracking enables automation and safe lifecycle management across concurrent SPECs.

What are the limitations of using standard Git branches for parallel SPEC development?

Standard Git branches require constant context-switching and are prone to merge conflicts when developing multiple SPECs concurrently. Isolated worktrees provide independent environments and central registration to ensure safe, scalable parallel work without these limitations.