finishing-a-development-branch

Identify the base branch, verify tests, and execute merge or PR workflows.

1|Updated Mar 8, 2024
One-click install
npx skills add https://github.com/cpp-for-everything/ORM --skill finishing-a-development-branch-cpp-for-everything
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/cpp-for-everything/ORM/tree/main/.windsurf/skills/finishing-a-development-branch
Command: npx skills add https://github.com/cpp-for-everything/ORM --skill finishing-a-development-branch-cpp-for-everything

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides teams to safely finalize work on a feature branch by verifying test results, selecting a clear path to completion, and performing the chosen action with proper cleanup.

Core Features & Use Cases

  • Verifies test results before finishing: ensures the feature branch passes the CI/test suite prior to merging or PR.
  • Presents exact completion options: merge locally, push and create a PR, keep the branch as-is, or discard the work.
  • Performs cleanup and reporting: cleans up worktrees/branches after completion and reports the outcome to stakeholders.

Quick Start

Initiate the finishing-a-development-branch process to review tests, choose a completion option, and clean up the worktree.

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 finish a git feature branch and clean up the worktree?

To finish a git feature branch, the workflow verifies CI test results, identifies the base branch, presents completion options like merging or creating a PR, and cleans up the worktree and branch automatically.

What is the best way to merge a development branch after CI testing passes?

The best way to merge a development branch after CI testing passes is to select a fixed completion option. You can merge locally, push and create a pull request, keep the branch as-is, or discard the work entirely.

Can I create a pull request and discard local changes when finishing a branch?

Yes, you can create a pull request or discard local changes when finishing a branch. The workflow provides exact completion options: merge locally, push and create a PR, preserve the branch, or discard the work.

Does finishing a branch verify test results before merging?

Yes, finishing a branch verifies test results before merging. The workflow ensures the feature branch passes the CI test suite prior to finalizing, preventing untested code from reaching the base branch.

How do I clean up git worktrees after completing a feature branch merge?

To clean up git worktrees after completing a feature branch merge, the workflow performs automatic cleanup of worktrees and branches after your chosen completion action executes, ensuring no residual artifacts remain.

When should I preserve a git feature branch instead of merging it?

You should preserve a git feature branch instead of merging when work is incomplete or needs review. The workflow allows keeping the branch as-is, bypassing merge or PR actions while maintaining the worktree state.