moai-workflow-worktree

Automate per-SPEC Git worktree creation and registration for MoAI-ADK workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation and management of per-SPEC Git worktrees to support parallel SPEC development.

Core Features & Use Cases

  • Isolated SPEC worktrees: Each SPEC gets its own worktree with independent Git state to prevent conflicts during parallel development.
  • Automatic registration: Worktrees are recorded in a central registry for visibility, auditing, and lifecycle tracking.
  • MoAI-ADK integration: Seamless Plan-Run-Sync workflow support with template-based environment setup and hook-driven automation.
  • Parallel development support: Enables concurrent SPEC workstreams without context switching, improving throughput.

Quick Start

Plan a SPEC with /moai:1-plan, which automatically creates a worktree if auto-create is enabled. Then switch to the worktree using moai-worktree go SPEC-ID and run /moai:2-run in the isolated environment. When ready, synchronize with /moai:3-sync and optionally remove the worktree with moai-worktree remove SPEC-ID.

Frequently Asked Questions about moai-workflow-worktree

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

FAQPage Schema
How do I isolate SPEC workspaces using Git worktrees?

You isolate SPEC workspaces by automating per-SPEC Git worktree creation, giving each specification its own independent Git state to prevent conflicts during parallel development.

How do I manage parallel SPEC development without context switching?

Parallel SPEC development is managed by creating isolated Git worktrees for each SPEC, enabling concurrent workstreams without context switching and improving overall throughput.

Do I need MoAI-ADK to automate worktree lifecycle control?

Yes, this Skill applies to teams running MoAI-ADK workflows, using template-driven environment setup and hook-driven automation to manage worktree lifecycle control and registration.

What's the best way to track Git worktrees in a central registry?

The best way to track Git worktrees is through automatic registration in a central registry, which provides visibility, auditing, and lifecycle tracking for all isolated SPEC workspaces.

How do I integrate Plan-Run-Sync workflows with isolated worktrees?

You integrate Plan-Run-Sync workflows by planning a SPEC to auto-create a worktree, switching to it, running tasks in isolation, then synchronizing and optionally removing the worktree.