skills.rest
Seung-zedd
Seung-zeddCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

moai-workflow-worktree

Manage Git worktrees for parallel SPEC development with isolated workspaces and branch registration.

Updated Aug 29, 2026
Search Tags:#tmux#git worktree#parallel development#workspace management#moai-adk#branch isolation#spec workflow
One-click install
npx skills add https://github.com/Seung-zedd/secure-file-upload --skill moai-workflow-worktree-seung-zedd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: moai-workflow-worktree
Source: https://github.com/Seung-zedd/secure-file-upload/tree/main/.claude/skills/moai-workflow-worktree
Command: npx skills add https://github.com/Seung-zedd/secure-file-upload --skill moai-workflow-worktree-seung-zedd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Developing multiple SPECs or features on a single branch causes merge conflicts, context-switching overhead, and blocked parallel work. This Skill creates and manages isolated Git worktrees so each SPEC gets its own workspace with independent Git state, files, and dependencies. ## Core Features & Use Cases - Isolated Worktree Management: Create, switch, sync, and remove worktrees per SPEC with a central JSON registry tracking status, branches, and sync history. - Parallel Development Workflow: Run multiple SPECs concurrently with independent dependency environments, development servers, and port assignments, integrated with the /moai plan, /moai run, and /moai sync phases. - Teammate Spawning: Launch Claude or GLM sessions in a new tmux window inside a worktree using the --spawn flag without abandoning the current session. - Use Case: While SPEC-AUTH-001 is under development in one worktree, create SPEC-PAY-001 in a second worktree, develop both in parallel, sync each with the base branch, and clean up merged worktrees automatically. ## Quick Start Ask the AI to create an isolated Git worktree for a new SPEC and switch into it to begin parallel 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 develop multiple Git branches in parallel without switching?▼

Use Git worktrees to check out multiple branches into separate directories simultaneously. Each worktree has independent Git state and files, so you can develop SPECs in parallel and switch instantly without stashing or committing in-progress work.

How do I create a Git worktree for a SPEC in MoAI-ADK?▼

Enter a worktree with the launcher command, for example moai cc -w feat-auth, which resolves short names under .claude/worktrees/. The plan phase runs on a plan branch in the main checkout; worktrees are entered by the user rather than auto-created by plan.

Does the --spawn flag work on Windows?▼

No, --spawn requires tmux, which is POSIX-only, so it reports a missing binary error on Windows. Entering a worktree in place with the -w flag works on every platform.

Why does worktree sync fail with uncommitted changes?▼

The sync operation aborts when uncommitted changes exist to prevent data loss. Commit your changes first, or use the force flag to override, and resolve merge conflicts with the interactive or auto-resolve options.

When should I clean up Git worktrees?▼

Remove worktrees after both the run PR and sync PR merge, using the disposal command for the SPEC. Stale worktree branches accumulate and confuse git worktree list, so always prune after a session ends.

Related Skills

Explore More Software Engineering Skills→
BillChiricoBillChirico
5

git-workspace-init

Create an isolated git worktree with conventional branch naming and upstream tracking.

Community
Intermediate
ulpi-ioulpi-io
13

git-merge-expert-worktree

Automate isolated git worktree merge workflows with lifecycle steps.

Official
Advanced
bastani-incbastani-inc
484

prek

Configure Git hooks with prek for formatting, linting, and validation checks.

Official
Intermediate
xotongxotong

ce-worktree

Automates isolated git worktree creation for parallel feature development and PR reviews.

Community
Advanced