moai-workflow-worktree

Manage isolated Git worktrees for parallel SPEC development.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of parallel feature development by giving each SPEC its own isolated Git worktree, preventing context switching, branch conflicts, and accidental interference between tasks.

Core Features & Use Cases

  • Isolated Workspaces: Create dedicated worktrees per SPEC so multiple features can progress independently.
  • Registry-Backed Management: Track active worktrees, metadata, sync state, and cleanup status in a central registry.
  • Workflow Integration: Support Plan-Run-Sync flows, including automatic setup, switching, synchronization, and cleanup.
  • Use Case: A developer planning two features at once can create separate worktrees, work on each in parallel, and sync them back cleanly when ready.

Quick Start

Ask the assistant to create a new worktree for your SPEC and switch you into it for isolated development.

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 feature branch development?

Git worktrees for parallel development are managed by creating isolated workspaces per SPEC and tracking them in a central registry, preventing branch conflicts and context switching.

What is the best way to isolate SPEC work when developing multiple features at once?

Isolating SPEC work is best handled by assigning each SPEC its own dedicated Git worktree, allowing multiple features to progress independently without accidental interference.

How do I track active Git worktrees and their synchronization state?

Active Git worktrees are tracked using a registry-backed management system that records metadata, synchronization state, and cleanup status for each branch-aware development workspace.

Can I automatically switch and sync isolated workspaces during a Plan-Run-Sync flow?

Yes, the workflow integration supports Plan-Run-Sync flows by providing automatic setup, switching between concurrent workspaces, synchronization handling, and cleanup for merged or stale branches.

How do I clean up stale Git worktrees after merging a feature branch?

Stale Git worktrees are handled through registry-based cleanup support that automatically manages the removal of merged or abandoned branches during the synchronization phase.