moai-workflow-worktree

Create and manage isolated Git worktrees for parallel SPEC development.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines parallel SPEC development by creating isolated Git worktrees, preventing context-switching overhead and development conflicts.

Core Features & Use Cases

  • Isolated Workspaces: Each SPEC gets its own independent Git worktree.
  • Parallel Development: Work on multiple SPECs simultaneously without interference.
  • Seamless Integration: Integrates with MoAI-ADK workflow phases (/moai:1-plan, /moai:2-run, /moai:3-sync).
  • Use Case: A developer needs to work on a new authentication feature (SPEC-AUTH) and a payment processing feature (SPEC-PAY) concurrently. This Skill allows them to create separate worktrees for each, develop them in parallel, and sync them independently.

Quick Start

Create a new worktree for SPEC-AUTH-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 feature development without context switching?

Git worktrees provide isolated workspaces for parallel feature development by creating independent directory branches. This Skill manages worktree creation and synchronization, preventing context-switching overhead and development conflicts when working on multiple SPECs simultaneously.

What is the best way to manage isolated workspaces for multiple SPECs?

Managing isolated workspaces for multiple SPECs involves assigning each SPEC its own Git worktree. This Skill automates branch registration and workspace creation, allowing independent development and synchronization for concurrent features.

How do I create and sync an isolated Git worktree for a new feature?

To create an isolated Git worktree for a new feature, specify the SPEC identifier and description. This Skill generates the worktree, registers the branch automatically, and allows independent syncing through integrated workflow phases.

Does this worktree workflow integrate with MoAI-ADK development phases?

Yes, the worktree workflow integrates seamlessly with MoAI-ADK phases including planning, running, and syncing. It supports automatic branch registration and cleanup of merged worktrees within the MoAI-ADK lifecycle.

How are merged Git worktrees cleaned up after parallel development?

Merged Git worktrees are cleaned up automatically through the Skill's synchronization features. After parallel development completes, the workflow handles branch registration and removes merged worktrees to maintain a clean workspace.