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.