moai-workflow-worktree

Manage isolated Git worktrees per SPEC with automatic registry registration and MoAI-ADK integration.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Git worktree management and MoAI-ADK integration are complex when developing multiple SPECs in parallel. This skill provides a registry-backed system to create, isolate, and track per-SPEC worktrees, reducing context switching and merge conflicts across teams.

Core Features & Use Cases

  • Isolated worktrees per SPEC enabling parallel development
  • Automatic registration and a central registry for tracking
  • MoAI-ADK integration for plan/run/sync workflows
  • Safe cleanup and template-based environment setup

Quick Start

Use the moai-worktree CLI to create and manage parallel SPEC worktrees:

  • moai-worktree new SPEC-001 "User Authentication"
  • moai-worktree switch SPEC-001
  • moai-worktree sync SPEC-001
  • moai-worktree remove 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 manage parallel SPEC development with isolated Git worktrees?

Managing parallel SPEC development with isolated Git worktrees involves using a registry-backed system to create, isolate, and track one SPEC per worktree, ensuring automatic registration and safe cleanup to reduce context switching and merge conflicts across teams.

What is the best way to coordinate multiple SPEC worktrees with MoAI-ADK?

Coordinating multiple SPEC worktrees with MoAI-ADK is best handled through a registry-driven lifecycle that integrates plan, run, and sync workflows, enabling automatic registration and template-based environment setup for scalable multi-SPEC projects.

How do I create and switch between isolated worktrees for different SPECs?

To create and switch between isolated worktrees for different SPECs, use the moai-worktree CLI commands: 'new' to create a worktree with automatic registration, and 'switch' to navigate between the isolated development environments.

Does MoAI-ADK support automatic worktree registration and safe cleanup?

Yes, MoAI-ADK supports automatic worktree registration and safe cleanup by enforcing a registry-driven lifecycle, which tracks per-SPEC worktrees and handles conflict management and automated removal upon project completion.

When do I need a registry-backed Git worktree system for development?

You need a registry-backed Git worktree system when developing multiple SPECs in parallel, as it enforces a registry-driven lifecycle for tracking isolated worktrees, applies template-based setup, and manages conflicts for scalable multi-SPEC projects.

How do I synchronize changes across parallel SPEC worktrees?

To synchronize changes across parallel SPEC worktrees, use the 'moai-worktree sync' CLI command, which integrates with MoAI-ADK workflows to coordinate updates and handle conflicts across the isolated development branches.