skills.rest
globalmsq
globalmsqOFFICIAL
Explore all skills by this author →
WebsiteGitHub

moai-workflow-worktree

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

Updated Aug 23, 2026
Search Tags:#automation#registry#git-worktree#spec-development#moai-adk#parallel-worktrees#moai-worktree
One-click install
npx skills add https://github.com/globalmsq/solo-relayer-service --skill moai-workflow-worktree-globalmsq
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: moai-workflow-worktree
Source: https://github.com/globalmsq/solo-relayer-service/tree/main/.claude/skills/moai-workflow-worktree
Command: npx skills add https://github.com/globalmsq/solo-relayer-service --skill moai-workflow-worktree-globalmsq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates and coordinates Git worktree management for parallel SPEC development within the MoAI-ADK workflow. It eliminates manual boilerplate, reduces context switching, and ensures consistent worktree governance.

Core Features & Use Cases

  • Isolated Worktrees: Each SPEC runs in its own worktree to prevent cross-contamination between parallel SPEC efforts.
  • Automatic Registration: Central registry with atomic updates tracks active worktrees and their state.
  • Template-Driven Setups: Pre-defined templates configure environments automatically after SPEC creation.
  • MoAI-ADK Integration: Seamless alignment with the Plan-Run-Sync lifecycle for end-to-end SPEC workflow.
  • Multi-Developer Coordination: Registry-based collaboration and visibility across teams.

Use cases include running several SPECs in parallel, rapidly iterating on architecture changes, and comparing different feature branches in isolation.

Quick Start

  • Plan a new SPEC with automatic worktree creation: /moai:1-plan "New SPEC" --worktree
  • Switch to the new worktree and start work: moai-worktree switch SPEC-001 or eval $(moai-worktree go SPEC-001)
  • Develop in isolation: /moai:2-run SPEC-001
  • Synchronize and finalize: moai-worktree sync SPEC-001 followed by /moai:3-sync SPEC-001
  • Cleanup when done: moai-worktree remove SPEC-001

Frequently Asked Questions about moai-workflow-worktree

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

FAQPage Schema
How do I manage Git worktrees for parallel SPEC development?▼

You can start parallel SPEC development by planning a new SPEC with the --worktree flag, switching to the new worktree using the switch command, and then running the development phase in that isolated directory.

What is the best way to isolate parallel feature branches in Git?▼

The registry-backed system uses atomic updates to track active worktrees and their state, ensuring that template-driven setups configure environments automatically after SPEC creation.

Does MoAI-ADK integration support automatic worktree registration?▼

This integration eliminates manual boilerplate, ensures consistent worktree governance, and provides registry-based collaboration and visibility across teams.

How do I synchronize and finalize a Git worktree after development?▼

The lifecycle includes support for templates, synchronization, conflict resolution, and automatic cleanup, leveraging standard Git worktree features for seamless finalization.

Can I use template-driven setups for Git worktree environments?▼

This ensures consistent worktree governance and eliminates manual boilerplate across multiple developers working on parallel SPEC efforts.

When should I avoid using automated Git worktree management?▼

The system is designed specifically for MoAI-ADK integration and registry-based collaboration, so simpler single-branch workflows may not benefit from its atomic-update lifecycle and conflict resolution features.

Related Skills

Explore More Software Engineering Skills→
modu-aimodu-ai
1.2k

moai-essentials-debug

Manage Git worktree environments for parallel SPEC development.

Official
Advanced
modu-aimodu-ai
1.2k

moai-essentials-perf

Create isolated Git worktrees for parallel SPEC development workflows.

Official
Advanced
yarangyarang

moai-workflow-spec

Manage SPEC workflows with EARS format for MoAI-ADK development.

Community
Advanced
mituso89mituso89
2

m-worktree

Create and manage isolated git worktrees for parallel feature development.

Community
Intermediate