finishing-a-development-branch

Verify tests and guide git branch completion through merge, pull request, keep, or discard workflows.

Updated Dec 22, 2025
One-click install
npx skills add https://github.com/acho1833/spreadline2 --skill finishing-a-development-branch-acho1833
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/acho1833/spreadline2/tree/main/.claude/commands/finishing-a-development-branch
Command: npx skills add https://github.com/acho1833/spreadline2 --skill finishing-a-development-branch-acho1833

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you wrap up completed development work by verifying tests, choosing the right integration path, and avoiding rushed or unsafe branch cleanup.

Core Features & Use Cases

  • Test Verification: Confirms the codebase is passing before any merge, PR, or discard action is taken.
  • Workflow Decision Support: Presents structured options for merging locally, opening a pull request, keeping the branch, or discarding it.
  • Branch Cleanup: Performs the selected git actions and handles worktree cleanup when appropriate.
  • Use Case: After finishing a feature branch and confirming tests pass, use this Skill to decide whether to merge it into main, create a PR, or preserve the branch for later.

Quick Start

Use the finishing-a-development-branch skill to verify tests and guide me through the safest way to complete this branch.

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 development branch after finishing a feature?

Safely finishing a development branch requires verifying tests pass first. You then choose to merge locally, open a pull request, keep the branch, or discard it, followed by safe git branch and worktree cleanup operations.

What steps should I follow to clean up a git worktree when finalizing a branch?

Cleaning up a git worktree during branch finalization involves selecting a completion workflow like merge or discard. The process then executes safe branch and worktree operations to remove the active workspace once the feature is integrated.

When should I open a pull request instead of merging a branch locally?

You should open a pull request instead of merging locally when team review is needed. The branch finalization workflow presents structured options to guide this decision after confirming tests pass and detecting the base branch.

Do I need to run tests before discarding a development branch in git?

Yes, test validation is required before discarding a development branch. The workflow mandates confirming the codebase is passing before guiding you through any merge, pull request, keep-as-is, or discard actions.

What is the best way to prepare a feature branch for release?

The best way to prepare a feature branch for release is to verify tests, detect the base branch, and select a safe integration path. This ensures the finalization process handles branch and worktree operations without rushed cleanup.

Can I keep a development branch as-is instead of merging it into the main branch?

Yes, you can keep a development branch as-is. The finalization workflow explicitly offers a keep-as-is option alongside merge, pull request, and discard, allowing you to preserve the branch for later work after validating tests.