skills.rest
soo-kate-yeon
soo-kate-yeonCOMMUNITY
Explore all skills by this author →
GitHub

moai-workflow-worktree

Create isolated Git worktrees for parallel SPEC development with MoAI-ADK integration.

Updated Nov 20, 2025
Search Tags:#git#workflow#worktree#parallel development#isolated workspace#spec development
One-click install
npx skills add https://github.com/soo-kate-yeon/shadowoo --skill moai-workflow-worktree-soo-kate-yeon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: moai-workflow-worktree
Source: https://github.com/soo-kate-yeon/shadowoo/tree/main/.agents/skills/moai-workflow-worktree
Command: npx skills add https://github.com/soo-kate-yeon/shadowoo --skill moai-workflow-worktree-soo-kate-yeon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines parallel development by creating isolated Git worktrees for each SPEC, eliminating context-switching overhead and preventing conflicts.

Core Features & Use Cases

  • Isolated Workspaces: Each SPEC gets its own worktree with independent Git state.
  • Parallel Development: Work on multiple SPECs simultaneously without interference.
  • Seamless Integration: Works with MoAI-ADK workflow (/moai:1-plan, /moai:2-run, /moai:3-sync).
  • Use Case: You need to develop three new features (SPECs) concurrently. This Skill allows you to set up three separate worktrees, develop each feature independently, and then sync them all before integration.

Quick Start

Use the moai-workflow-worktree skill to create a new worktree for SPEC-001 with the description User Authentication.

Frequently Asked Questions about moai-workflow-worktree

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

FAQPage Schema
How do I use Git worktrees for parallel SPEC development without context switching?▼

Git worktrees provide isolated workspaces for each SPEC, allowing parallel development without interference. This approach eliminates context-switching overhead by maintaining independent Git states for separate features concurrently.

Can I manage multiple isolated workspaces for different feature branches simultaneously?▼

Yes, isolated workspaces support simultaneous development of multiple SPECs. Each feature receives its own worktree with an independent Git state and automatic branch registration, preventing conflicts during concurrent development.

Does the MoAI-ADK workflow integrate with isolated Git worktree operations?▼

Yes, the workflow integrates seamlessly with MoAI-ADK commands like /moai:1-plan, /moai:2-run, and /moai:3-sync. This allows you to plan, execute, and synchronize parallel SPEC development across isolated worktrees.

What is the best way to set up a new worktree for a specific feature SPEC?▼

To set up a worktree, invoke the skill and specify the SPEC identifier and description. This creates an isolated workspace with automatic branch registration, ready for immediate parallel development.

Why should I use isolated worktrees instead of standard Git branches for concurrent feature development?▼

Isolated worktrees prevent context-switching overhead and branch conflicts by providing separate working directories for each SPEC. Unlike standard branches, they allow you to develop multiple features simultaneously without interference.

When do I need to sync parallel SPEC workspaces before final integration?▼

You sync parallel SPEC workspaces after developing features independently and before final integration. Using the /moai:3-sync command consolidates changes from isolated worktrees to prepare for merging.

Related Skills

Explore More Software Engineering Skills→
alexanderopalexanderop

using-git-worktrees

Create isolated git worktrees for feature branches with safety checks.

Community
Advanced
modu-aimodu-ai
1.2k

moai-lang-shell

Manage Git worktrees for parallel SPEC development with CLI commands.

Official
Intermediate
modu-aimodu-ai
1.2k

Authoring CLAUDE.md Project Instructions

Automate Git worktree management for parallel SPEC development.

Official
Basic
fgarofalo56fgarofalo56
6

git-worktrees

Manage multiple Git worktrees for parallel branch checkouts in isolated directories.

Community
Intermediate