finishing-a-development-branch

Validates tests and presents merge, PR, keep, or discard options for Git branches.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/handsomelong922/my-codex-skills --skill finishing-a-development-branch-handsomelong922
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/handsomelong922/my-codex-skills/tree/main/skills/finishing-a-development-branch
Command: npx skills add https://github.com/handsomelong922/my-codex-skills --skill finishing-a-development-branch-handsomelong922

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinate the finalization of a completed development branch by validating tests and presenting structured completion options to guide the merge, PR, or cleanup decision.

Core Features & Use Cases

  • Verify test results and determine readiness for integration.
  • Detect the base branch and present four explicit actions: merge locally, push and create a PR, keep the branch as-is, or discard the work.
  • Execute the chosen workflow, including optional cleanup of worktrees when applicable.

Quick Start

Decide how to finish the current development branch by selecting one of the four options and starting the corresponding 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 finalize a development branch after tests pass?

To finalize a development branch, you validate tests and choose from four structured options: merge locally, push for a PR, keep the branch, or discard the work. This structured workflow ensures safe integration and cleanup.

What are the options for finishing a git workflow when work is complete?

The options for finishing a git workflow include merging locally, pushing to create a pull request, keeping the branch as-is, or discarding the work. These choices guide the finalization and optional worktree cleanup.

Do I need a valid test run before merging a development branch?

Yes, a valid test run is required before merging a development branch. The finalization process enforces deterministic steps that verify test results to determine readiness for integration before presenting merge or cleanup options.

Can I discard work and cleanup worktrees when finalizing a branch?

Yes, you can discard work and cleanup worktrees when finalizing a branch. The process presents explicit actions including discarding the work, which triggers safe cleanup of worktrees when finishing the development effort.

What's the best way to manage pull request creation from a finished branch?

The best way to manage pull request creation is using a structured finalization process that detects the base branch and offers to push and create a PR. This ensures the completed work is safely integrated.

When should I keep a branch for later instead of merging?

You should keep a branch for later instead of merging when the work is not ready for integration or requires future updates. The finalization workflow explicitly offers keeping the branch as-is as one of its four options.