moai-workflow-worktree

Manage Git worktrees for parallel SPEC development with MoAI-ADK integration.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines parallel software development by providing isolated, self-contained workspaces for each SPEC, eliminating context-switching overhead and preventing conflicts.

Core Features & Use Cases

  • Isolated Workspaces: Each SPEC gets its own Git worktree with independent state.
  • Parallel Development: Work on multiple SPECs simultaneously without interference.
  • Seamless Integration: Integrates with MoAI-ADK workflow (/moai:1-plan, /moai:2-run, /moai:3-sync).
  • Use Case: A developer needs to work on three different features (SPECs) concurrently. Instead of juggling branches in a single repository, they create three separate worktrees, one for each SPEC, allowing them to switch instantly and develop in complete isolation.

Quick Start

Create a new worktree for SPEC-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 development on multiple features?

To use git worktrees for parallel development, create a separate worktree for each SPEC to get an independent Git state and file system, allowing instant switching and interference-free development across multiple features.

What is the best way to manage context switching between multiple git branches?

The best way to manage context switching is using git worktrees to provide independent Git states and file systems for each SPEC, eliminating the overhead of juggling branches in a single repository.

Does MoAI-ADK workflow support isolated git workspaces?

Yes, MoAI-ADK supports isolated git workspaces through seamless integration, allowing you to execute /moai:1-plan, /moai:2-run, and /moai:3-sync workflows within each independent worktree.

How do I create a new worktree for a specific SPEC?

You create a new worktree for a specific SPEC by providing a SPEC identifier, such as SPEC-001, and a description like "User Authentication" to generate an automatically registered isolated workspace.

When should I clean up merged git worktrees?

You should clean up merged git worktrees after the parallel development workflow concludes, as the system supports automated cleanup of these merged worktrees to maintain repository hygiene.