parallel-worktree-dev

Manages parallel Git worktree development with direct testing via mcdev-tools before merging.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/Coral5644/NekansModPack --skill parallel-worktree-dev-coral5644
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: parallel-worktree-dev
Source: https://github.com/Coral5644/NekansModPack/tree/main/.cursor/skills/parallel-worktree-dev
Command: npx skills add https://github.com/Coral5644/NekansModPack --skill parallel-worktree-dev-coral5644

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Traditional Minecraft mod development forces a merge-test-rollback cycle because features can only be tested after merging into the main workspace. This Skill replaces that loop with Git worktrees plus mcdev-tools, letting you test feature workspaces directly without any git merge until the feature is confirmed. ## Core Features & Use Cases - Parallel Feature Workspaces: Creates isolated Git worktrees with feature branches, copying IDE configuration and committing pending main-workspace changes first for a stable baseline. - Direct Testing Without Merge: Switches the .mcdev.json included_mod_dirs path so mcdev-tools loads the feature workspace code directly, with optional AI-assisted testing through the mcdk_dev MCP server (screenshots, code execution, log reading, hot reload). - Safe Integration & Cleanup: Merges only after tests pass, restores .mcdev.json to main-workspace paths before merging to avoid path pollution, and requires user confirmation before removing worktrees or branches. - Use Case: You are building a new gameplay feature while another feature is in progress. The Skill creates a separate worktree, points mcdev-tools at it, lets you test and fix in place, then merges into main only after you confirm the feature works. ## Quick Start Ask the assistant to start a new feature using the parallel worktree workflow and tell it whether you want to work in the main workspace or a new feature workspace.

Frequently Asked Questions about parallel-worktree-dev

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

FAQPage Schema
How do I test a Git worktree feature branch without merging?▼

Point the .mcdev.json included_mod_dirs field at the feature worktree path, stop the running game, and restart mcdk. The game loads the feature workspace code directly, so no git merge is needed for testing.

How to create a Git worktree for parallel feature development?▼

First commit any uncommitted changes in the main workspace, then run git worktree add ../<repo>-<name> -b feat/<name> from the repo root. Copy IDE config folders like .cursor and .vscode into the new worktree afterward.

What is mcdev-tools and how does it work with mcdk?▼

mcdev-tools is a VSCode extension that works with mcdk to launch Minecraft mod testing. It reads .mcdev.json to decide which directory's mod code to load and exposes an mcdk_dev MCP server for screenshots, code execution, and log reading.

Can multiple Minecraft game instances run in parallel worktrees?▼

No, the Minecraft process cannot run in parallel across worktrees. However, switching test targets only requires editing included_mod_dirs in .mcdev.json and restarting mcdk, with no git operations involved.

Why does .mcdev.json get overwritten after merging a worktree?▼

If the feature worktree's .mcdev.json with its local path was committed, merging carries that path into main. Restore it with git checkout main -- .mcdev.json before merging, or add .mcdev.json to .gitignore.

When should I merge a feature worktree back into main?▼

Merge only after the feature passes testing in its own worktree, since merging is an integration step rather than a testing method. Sync main into the feature branch first and resolve conflicts there before the final merge.