Skip to content
Skill

finishing-a-development-branch

by obra

AI Summary

Guides developers through the final stages of completing a development branch by verifying tests pass and presenting structured options for merging, creating PRs, or cleanup. Useful for developers who want a systematic approach to integrating completed work.

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "finishing-a-development-branch" skill in my project.

Please run this command in my terminal:
# Install skill into your project
mkdir -p .claude/skills/finishing-a-development-branch && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/finishing-a-development-branch/SKILL.md "https://raw.githubusercontent.com/obra/superpowers/main/skills/finishing-a-development-branch/SKILL.md"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup

Overview

Guide completion of development work by presenting clear options and handling chosen workflow. Core principle: Verify tests → Present options → Execute choice → Clean up. Announce at start: "I'm using the finishing-a-development-branch skill to complete this work."

Step 1: Verify Tests

Before presenting options, verify tests pass: `bash

Run project's test suite

npm test / cargo test / pytest / go test ./... ` If tests fail: ` Tests failing (<N> failures). Must fix before completing: [Show failures] Cannot proceed with merge/PR until tests pass. ` Stop. Don't proceed to Step 2. If tests pass: Continue to Step 2.

Try common base branches

git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null ` Or ask: "This branch split from main - is that correct?"

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 13d ago
Active
Adoption1K+ stars on GitHub
162.8k ★ · Popular
DocsREADME + description
Well-documented

GitHub Signals

Stars162.8k
Forks14.2k
Issues306
Updated13d ago
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code