finishing-a-development-branch

Installation
Summary

Structured workflow for completing development branches with test verification and merge/PR options.

  • Verifies all tests pass before presenting integration options, preventing broken code from being merged or submitted
  • Presents exactly four choices: merge locally, create a pull request, keep the branch as-is, or discard with confirmation
  • Executes the chosen workflow, including base branch detection, git operations, and worktree cleanup
  • Integrates with subagent-driven-development and executing-plans skills to finalize completed work
SKILL.md

Finishing a Development Branch

Overview

Core principle: Verify tests → Detect environment → Present options → Execute choice → Clean up.

Announce at start: "I'm using the finishing-a-development-branch skill to complete this work."

Step 1: Verify Tests

Run the project's full test suite (npm test / cargo test / pytest / go test ./...).

If tests fail, report the failures and stop — the menu comes after a green suite:

Tests failing (<N> failures). Must fix before completing:

[Show failures]
Related skills
Installs
157.5K
GitHub Stars
270.2K
First Seen
Jan 19, 2026
finishing-a-development-branch — obra/superpowers