finishing-a-development-branch

Automate development branch finalization with merge, PR, keep, or discard options.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/softbreezee/claw-os --skill finishing-a-development-branch-softbreezee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/softbreezee/claw-os/tree/main/temp_skills/superpowers-main/skills/finishing-a-development-branch
Command: npx skills add https://github.com/softbreezee/claw-os --skill finishing-a-development-branch-softbreezee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finishing a development branch often requires careful coordination of tests, base-branch choice, and cleanup. This skill guides completion by presenting a deterministic four-option workflow and automated cleanup steps.

Core Features & Use Cases

  • Structured finish options: four explicit actions for finalizing work (merge locally, push and PR, keep as-is, or discard).
  • Test-driven completion: verifies tests pass before any merge or PR.
  • Base-branch detection & cleanup: identifies the appropriate base branch and cleans up worktrees post-completion.

Quick Start

Start the finishing-a-development-branch skill to verify tests, decide the base branch, choose the finish 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 finalize a git development branch with proper merge and cleanup options?

To finalize a git development branch, you can use a structured workflow that verifies tests pass, detects the base branch, and presents four explicit options: merge locally, push and create a pull request, keep the branch as-is, or discard it entirely.

Can I create a pull request from a git worktree and clean it up automatically?

Yes, you can create a pull request from a git worktree and trigger automatic worktree cleanup. The workflow pushes your changes, creates the PR, and then handles local and remote worktree removal post-completion.

What is the best way to ensure tests pass before merging a git branch locally?

The best way to ensure tests pass before a local git branch merge is to use an automated test verification step. This enforces test-driven completion by blocking the merge action until all tests successfully pass.

How do I safely discard a git branch and remove its worktree?

To safely discard a git branch and remove its worktree, you can select the discard option from a structured finish flow. This enforces safeguards to prevent unsafe actions while cleaning up the local and remote worktree.

Does the branch finishing workflow automatically detect the base branch for a merge?

Yes, the branch finishing workflow automatically detects the appropriate base branch for merging. This ensures your local merge or pull request targets the correct parent branch without manual configuration errors.