What problem does it solve?
When multiple agents or developers work in parallel git worktrees, folding a finished branch back into main involves many error-prone manual steps: conflict resolution, dependency installs, type/test/lint gates, worktree cleanup, and stale spec file removal. This Skill automates that entire integration workflow so nothing is forgotten.
Core Features & Use Cases
- End-to-end merge pipeline: Verifies a clean worktree, acquires a main write lock, merges with --no-ff, resolves conflicts, and runs build, type-check, test, lint, and selective e2e gates before committing.
- Safe worktree teardown: Stops dev/watch processes (next dev, tsx watch, turbo) to avoid ENOTEMPTY failures, closes the worktree via the gw wrapper, deletes the merged branch, and optionally closes the matching tmux window.
- Post-merge hygiene: Runs a simplify pass with mandatory adversarial review before committing refactors, cleans up stale spec/task files, advances serial kickoff chains, and triggers docs refresh at drain points.
- Use Case: After a parallel agent finishes a feature in worktree 'page-bookmark', run the skill with that identifier to merge it into main, verify all checks pass, close the worktree, and hand off to the next chained feature.
Quick Start
Integrate the finished worktree named page-bookmark into main and clean everything up.
