moai-workflow-worktree

Git worktrees for parallel SPEC development are managed through a registry-backed system that creates isolated workspaces per SPEC. This prevents cross-contamination between efforts and ensures conflict-aware synchronization with minimal interference to main branches.

The best way to isolate multiple SPEC workspaces is using a template-driven worktree creation process. Each SPEC receives its own isolated worktree registered in a central registry for fast discovery and coordination across parallel development efforts.

To create and switch to a SPEC worktree, you plan the SPEC with an automated worktree creation flag, then use a switch command to navigate to the isolated workspace. Finally, evaluate the go command to develop and execute the SPEC within that environment.

Worktree synchronization handles conflicts through a conflict-aware sync phase that integrates with the main workflow. It guides synchronization of completed worktrees with base branches to ensure minimal interference before automated cleanup occurs.

Parallel worktree management is designed to apply across the MoAI-ADK workflow, seamlessly interacting with Plan, Run, and Sync phases. It satisfies requirements for a registry-backed creation process and per-worktree isolation within that specific ecosystem.