finishing-a-development-branch

Guides completion of development branches through merge, pull request, or cleanup options.

92|12|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/ARounder-183/HiFiShifter --skill finishing-a-development-branch-arounder-183
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/ARounder-183/HiFiShifter/tree/main/.github/skills/finishing-a-development-branch
Command: npx skills add https://github.com/ARounder-183/HiFiShifter --skill finishing-a-development-branch-arounder-183

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When implementation work is done, developers often face an ambiguous decision point: merge locally, open a pull request, keep the branch, or discard it. This Skill removes that ambiguity by verifying tests first, then presenting exactly four structured options and executing the chosen workflow safely. ## Core Features & Use Cases - Test Gate Before Completion: Runs the project's test suite (npm test, cargo test, pytest, go test) and blocks any merge or PR if tests fail. - Four Structured Options: Presents merge locally, push and create PR, keep branch as-is, or discard work, then executes the chosen path with the correct git commands. - Safe Cleanup and Discard Protection: Cleans up git worktrees only when appropriate and requires typed 'discard' confirmation before permanently deleting branches and commits. - Use Case: After finishing a feature branch in a git worktree, invoke this Skill to verify tests pass, create a pull request via gh pr create, and clean up the worktree in one guided flow. ## Quick Start Ask the assistant to finish the current development branch and choose whether to merge it, open a pull request, keep it, or discard it.

Frequently Asked Questions about finishing-a-development-branch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I finish a development branch after implementation is complete?

First verify the project's test suite passes, then choose one of four options: merge locally into the base branch, push and create a pull request, keep the branch as-is, or discard the work. Each option has a defined git command sequence.

How do I create a GitHub pull request from a feature branch?

Push the branch with git push -u origin <branch>, then run gh pr create with a title and body containing a summary of changes and a test plan checklist. Verify tests pass before pushing.

Should I merge a branch if some tests are failing?

No. Failing tests block all completion paths. Fix the failures first, rerun the test suite, and only proceed with merge or pull request creation once everything passes.

When should git worktrees be cleaned up after merging?

Clean up the worktree with git worktree remove only after a local merge or a confirmed discard. Keep the worktree when creating a pull request or keeping the branch, since the work may still be needed.

How do I safely delete a development branch and its commits?

Require explicit typed confirmation of 'discard' listing the branch, commits, and worktree to be deleted. Then switch to the base branch, force-delete with git branch -D, and remove the worktree.