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.