finishing-a-development-branch

Automates Git merge, PR, or cleanup workflows after tests pass and branch selection.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/victorqnguyen/victors-architecture --skill finishing-a-development-branch-victorqnguyen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/victorqnguyen/victors-architecture/tree/main/packages/core/skills/finishing-a-development-branch
Command: npx skills add https://github.com/victorqnguyen/victors-architecture --skill finishing-a-development-branch-victorqnguyen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides teams to finish development work by validating tests, selecting a merge-related path, and cleaning up the feature branch.

Core Features & Use Cases

  • Verify tests pass before completing and presenting options.
  • Determine the base branch and choose one of four explicit workflows (merge locally, push and open PR, keep the branch, or discard).
  • Cleanup worktrees and branches after the chosen option, with safeguards to prevent data loss.

Quick Start

Verify tests, identify the base branch, and select one of the four completion options to finalize your development work.

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, a structured workflow verifies test success, determines the base branch, and presents explicit merge, pull request, or discard options to safely integrate completed development work.

What is the best way to clean up local Git branches after merging a pull request?

The best way to clean up local Git branches after merging is to use a workflow that offers optional post-merge cleanup for worktrees and branches, applying safeguards to prevent data loss during the finalization process.

Can I choose between opening a pull request and merging locally when finishing a development branch?

Yes, you can choose between opening a pull request and merging locally when finishing a development branch. The workflow provides four explicit completion options: merge locally, push and open PR, keep the branch, or discard changes.

Does the branch finalization workflow verify tests before allowing a merge?

Yes, the branch finalization workflow verifies that tests pass before completing and presenting integration options. This ensures test success is validated prior to base-branch determination and the execution of any merge or cleanup actions.

How do I prevent data loss when deleting Git worktrees and feature branches?

To prevent data loss when deleting Git worktrees and feature branches, use a finalization workflow that includes built-in safeguards during post-merge cleanup, ensuring branches are only removed after successful integration.