finishing-a-development-branch

Verify tests and integrate a completed git development branch.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/MINT-IA/MINT --skill finishing-a-development-branch-mint-ia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/MINT-IA/MINT/tree/main/.claude/skills/finishing-a-development-branch
Command: npx skills add https://github.com/MINT-IA/MINT --skill finishing-a-development-branch-mint-ia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers conclude work on a feature branch by ensuring tests are verified, presenting a concise set of integration choices, and executing the chosen workflow while preventing accidental data loss.

Core Features & Use Cases

  • Test-first verification: Mandates running the project's test suite and halts if tests fail to avoid merging broken code.
  • Structured decision flow: Presents exactly four options—merge locally, push and create a PR, keep the branch, or discard—with clear execution steps for each.
  • Safe cleanup and confirmations: Detects and removes git worktrees when appropriate and requires typed confirmation before destructive operations.
  • Use Case: After completing a feature and confirming all tests pass, use this Skill to either merge locally, push and open a pull request with a structured PR body, preserve the branch for later work, or safely discard it with confirmation.

Quick Start

Use the finishing-a-development-branch skill to verify tests, choose merge/push/keep/discard, and perform the selected git workflow.

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

To safely merge a git feature branch, the workflow requires running the project's test suite first, halting if tests fail, then choosing to merge locally, push and open a pull request, keep the branch, or discard it with typed confirmation.

What is the best way to clean up git worktrees when discarding a branch?

Cleaning up git worktrees when discarding a branch requires detecting associated worktrees, removing them when appropriate, and requiring typed confirmation before executing destructive branch deletions to prevent accidental data loss.

Can I open a pull request directly from my local git workflow?

Yes, you can open a pull request directly from your local git workflow by selecting the push and create a PR option after verifying passing tests, which pushes the branch and generates a structured PR body for the target codebase.

How do I determine the correct base branch before integrating a development branch?

To determine the correct base branch before integrating a development branch, the workflow automatically detects the merge-base to identify the target codebase branch, ensuring the feature integration applies to the correct repository lineage.

Why should I run tests before merging a development branch?

Running tests before merging a development branch is required to prevent integrating broken code, as the workflow mandates executing the project's test suite and halts the integration process immediately if any tests fail.

Does this branch integration workflow support keeping a branch for later work?

Yes, the branch integration workflow supports keeping a branch for later work by offering a structured decision flow that allows developers to preserve the current development branch instead of merging, pushing, or discarding it.