finishing-a-development-branch

Automate branch finalization with merge, PR, keep, or discard options.

Updated Jul 14, 2025
One-click install
npx skills add https://github.com/woodrowpearson/mids-hero-web --skill finishing-a-development-branch-woodrowpearson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/woodrowpearson/mids-hero-web/tree/main/.claude/skills/finishing-a-development-branch
Command: npx skills add https://github.com/woodrowpearson/mids-hero-web --skill finishing-a-development-branch-woodrowpearson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the finalization of a development branch by guiding a structured set of decisions after tests pass, ensuring a clean, auditable merge or discard workflow.

Core Features & Use Cases

  • Structured four-option workflow: Merge locally, push and create a PR, keep the branch for later, or discard the work with explicit confirmation.
  • Automated base-branch detection: Infers the appropriate base branch (main/master) to ensure correct lineage during merge.
  • Test-driven gating: Requires tests to pass before offering completion options, preventing broken integrations.
  • Auditable cleanup: Optionally cleans up worktrees and local branches to maintain a tidy repo after completion.

Quick Start

Verify tests pass, then follow one of the four presented options:

  1. Merge back to the base branch locally
  2. Push and create a Pull Request
  3. Keep the branch as-is (I'll handle it later)
  4. Discard this work After making a choice, the skill will perform the corresponding actions and clean up as described.

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 finalize a git feature branch after tests pass?

To finalize a git feature branch after tests pass, you can choose from a structured four-option workflow: merge locally to the base branch, push and create a pull request, keep the branch for later, or discard the work entirely with explicit confirmation.

What is the best way to merge a development branch back to the main or master branch?

The best way to merge a development branch is using automated base-branch detection to infer the correct main or master lineage, ensuring a clean and auditable integration directly through standard Git operations after test verification.

Do I need to run tests before creating a pull request or merging a branch?

Yes, you need to run tests before creating a pull request or merging a branch. Test-driven gating requires tests to pass before offering any completion options, preventing broken integrations and ensuring code stability.

How can I safely discard git branch changes and clean up the local worktree?

To safely discard git branch changes and clean up the local worktree, select the discard option which requires explicit confirmation before abandoning the work, followed by optional auditable cleanup commands to remove local branches and maintain a tidy repository.

Can I keep a feature branch without merging or creating a pull request immediately?

Yes, you can keep a feature branch without merging or creating a pull request immediately. The workflow offers a specific option to keep the branch as-is for later handling, leaving the current repository state untouched.