What problem does it solve?
Developers often face uncertainty when completing work on a feature branch, leading to broken merges, accidental data loss, or unhandled worktree cleanup that leaves stale git state.
Core Features & Use Cases
- Mandatory test verification: Ensures no broken code is merged or pushed by requiring all tests to pass before presenting integration options.
- Environment-aware workflows: Detects git repository state (normal repo, named worktree, detached HEAD) to present the correct set of integration and cleanup options.
- Safe end-to-end handling: Manages the full branch completion process from merge/PR creation to provenance-aware worktree and branch cleanup, with guardrails like confirmation prompts for destructive actions.
- Use Case: After finishing a feature on a git worktree, use this skill to safely merge changes to the main branch, push a PR for team review, or clean up the branch if the work is no longer needed, without risking lost commits or failing CI.
Quick Start
Use the finishing-a-development-branch skill to safely complete work on your current feature branch once all project tests pass.