multi-worktree-dev

Handbook for designing and deploying parallel multi-worktree development environments — helps teams define a layered environment strategy that supports concurrent worktree development, parallel testing, and stable shared infrastructure.

Core Design Goals

Goal	Specific Design
Zero complexity	Creating a new worktree requires no manual configuration — `make dev` handles all setup automatically
Parallel safety	Tests across multiple worktrees run fully in parallel without blocking each other
Shared channel exclusivity	Singleton channels like Feishu WS are held by only one worktree at a time
Instant layer switching	Layer 1 stays running; switching worktrees only requires starting L2/L3
Zero port conflicts	Ports are assigned via automatic hash offset; developers never need to manually edit configuration
Smooth development	Layer 3 is fully hot-reloaded; code changes require no process restart

Description

This Skill covers designing a local environment system from scratch that supports parallel multi-branch development. The core idea is the following three-layer separation structure: