superpowers-finishing-a-development-branch

Verify tests and select a merge, PR, keep, or discard path.

Updated Dec 16, 2025
One-click install
npx skills add https://github.com/fegome90-cmd/fork_agent --skill superpowers-finishing-a-development-branch-fegome90-cmd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superpowers-finishing-a-development-branch
Source: https://github.com/fegome90-cmd/fork_agent/tree/main/.kilocode/skills/superpowers-finishing-a-development-branch
Command: npx skills add https://github.com/fegome90-cmd/fork_agent --skill superpowers-finishing-a-development-branch-fegome90-cmd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finishing development work requires validation, decision making, and clean handoff. This skill guides you to complete work by verifying tests, identifying the base branch, presenting a fixed set of options for merging, PR creation, keeping or discarding the feature branch, and finally performing optional cleanup of worktrees.

Core Features & Use Cases

  • Verify tests and determine a base branch to ensure safe integration.
  • Present exactly four actionable options: merge locally, push and create PR, keep as-is, or discard, with deterministic execution steps.
  • Clean up worktrees after option execution and support integration with other skills in a multi-step workflow.

Quick Start

Run the finishing-a-development-branch skill on your feature branch to guide final integration decisions.

Frequently Asked Questions about superpowers-finishing-a-development-branch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the best way to finish a development branch and decide between merging or creating a pull request?

Finishing a development branch is streamlined by verifying tests, detecting the base branch, and choosing from four options: merge locally, push and create a PR, keep as-is, or discard. This ensures safe integration and deterministic execution for your workflow.

How do I verify tests before merging a git feature branch?

Before merging a git feature branch, you should run test validation as a guardrail step. This skill specifies test verification as a prerequisite step to ensure safe integration before selecting a final path like a local merge or pull request.

Does this branch cleanup workflow support git worktrees?

Yes, this branch cleanup workflow supports git worktrees by performing optional worktree cleanup after executing your chosen integration option. This ensures your multi-branch environment remains tidy after finishing development work.

What steps should I follow to discard a feature branch safely?

To discard a feature branch safely, the workflow presents discarding as one of four fixed options after test validation. Selecting this option triggers deterministic execution steps to remove the branch and perform optional worktree cleanup.

Can I use this skill for local merges in a multi-branch environment?

Yes, you can use this skill for local merges in a multi-branch environment. It applies to branching workflows by detecting the base branch and guiding the local merge process with clear, actionable steps and guardrails.

Why should I use a guided workflow for pull request creation instead of manual git commands?

A guided workflow for pull request creation prevents integration errors by enforcing test validation and base-branch detection before pushing. It provides deterministic execution steps and optional worktree cleanup, ensuring a clean handoff that manual commands often miss.