moai-workflow-worktree

Isolated git worktrees for parallel SPEC development are created and synchronized automatically, preventing environment conflicts. A central registry tracks active worktrees, allowing teams to switch between features and sync changes seamlessly.

A git worktree is an independent working directory linked to a single repository, needed when developing multiple SPECs in parallel. It allows you to isolate environments, automatically registering each branch so teams can switch contexts without conflicts.

MoAI-ADK integration supports worktree synchronization across plan, run, and sync phases with minimal manual intervention. It handles conflict detection, cleanup, and environment setup, ensuring seamless coordination throughout the parallel development lifecycle.

To create a new worktree for a SPEC, use the automated workflow to generate the isolated directory and register it in the central registry. You can then switch directly into the new environment to begin development or testing immediately.

Parallel git worktrees require active conflict detection and proper cleanup to avoid environment sprawl. You should not use them without central registration, as losing track of active worktrees can disrupt team coordination and synchronization.