finishing-a-development-branch

Verify tests and guide merge, pull request, keep, or discard decisions for a development branch.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ArthTech-AI/Marketplace-extensions --skill finishing-a-development-branch-arthtech-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/ArthTech-AI/Marketplace-extensions/tree/main/skills/superpowers/finishing-a-development-branch
Command: npx skills add https://github.com/ArthTech-AI/Marketplace-extensions --skill finishing-a-development-branch-arthtech-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you finish completed development work without guessing what to do next. It verifies the project is in a releasable state and then guides the right next step for merging, creating a pull request, keeping the branch, or discarding it.

Core Features & Use Cases

  • Test Gatekeeping: Checks that the codebase passes tests before any completion action is offered.
  • Branch Handoff Decisions: Presents a fixed set of outcomes for local merge, PR creation, preserving work, or cleanup.
  • Safe Destructive Actions: Requires explicit confirmation before deleting work, reducing the chance of accidental loss.
  • Worktree Cleanup: Removes associated worktrees when the chosen action requires it.
  • Use Case: A feature branch is done and tested, but the team has not decided whether to merge it now or open a PR, so the Skill walks through the choice and executes it safely.

Quick Start

Use this skill to finish the current development branch by checking tests and then guiding the merge, pull request, keep-as-is, or discard decision.

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 feature branch after testing is complete?▼

To safely merge a git feature branch, the system first runs tests to verify a releasable state, detects the base branch, and then presents a local merge as one of four structured completion options, ensuring clean branch handoff without accidental data loss.

What is the best way to clean up git worktrees when discarding a branch?▼

The best way to clean up git worktrees during branch discard is to require explicit confirmation for the destructive deletion action before automatically removing the associated worktrees. This prevents accidental loss of unreviewed work while ensuring the local environment is tidied up.

Can I create a pull request directly from a local development branch?▼

Yes, you can create a pull request directly from a local development branch. After verifying that all tests pass, the workflow presents pull request creation as a structured handoff option alongside local merge, keeping, or discarding the completed feature work.

Does finishing a development branch require passing tests first?▼

Yes, finishing a development branch requires passing tests first. The workflow applies test gatekeeping to check that the project is in a releasable state before offering any completion actions like merging, pull request creation, or discarding the work.

How do I keep a git branch for later use without merging it immediately?▼

To keep a git branch for later use without merging, you select the preserve work option from the structured handoff decisions presented after tests pass. This leaves the development branch intact and skips any worktree cleanup associated with finalizing or discarding.