finish-branch

What problem does it solve?

When implementation is complete, it is unclear whether to merge, open a pull request, keep the branch, or discard work while ensuring tests and documentation gates are respected. This Skill provides a safe, repeatable workflow that verifies automated tests, reminds about documentation updates, and enforces confirmation for destructive actions before changing branch state.

Core Features & Use Cases

• Test Gate: Auto-detects and runs the appropriate test command (npm, cargo, pytest, go test, xcodebuild) and stops if tests fail.
• Integration Options: Presents exactly four choices — merge locally, push and create a PR, keep the branch, or discard — and executes the selected git/gh commands.
• Repository Hygiene: Checks documentation paths for feature specs, ADRs, and changelog reminders, determines the correct merge base, and conditionally cleans up git worktrees.
• Use Case: Use after finishing a feature to ensure tests pass, choose the integration strategy, and perform safe cleanup including worktree removal when applicable.

Quick Start

Finish the current feature branch by running tests, choose whether to merge locally or create a PR, and perform any necessary branch and worktree cleanup.