finishing-a-development-branch

Structured workflow for completing development branches with test verification and merge/PR options.

obra ↓ 140k

Claude Code

View source ↗

What it does

Branch <name>
All commits: <commit-list>
Worktree at <path>
Problem: Merge broken code, create failing PR
Fix: Always verify tests before offering options
Problem: "What should I do next?" is ambiguous
Fix: Present exactly 4 structured options (or 3 for detached HEAD)

Requirements & configuration

Do NOT clean up worktree — user needs it alive to iterate on PR feedback.
Problem: Remove worktree user needs for PR iteration
Fix: Require typed "discard" confirmation

Configuration: GIT_DIRMAIN_ROOTWORKTREE_PATH

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

Structured workflow for completing development branches with test verification and merge/PR options.

Source

Repository: https://github.com/obra/superpowers

finishing-a-development-branch FAQ

What does the finishing-a-development-branch skill do?

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 Branch <name> All commits: <commit-list>

What does finishing-a-development-branch require?

Do NOT clean up worktree — user needs it alive to iterate on PR feedback. Problem: Remove worktree user needs for PR iteration Fix: Require typed "discard" confirmation Configuration keys: GIT_DIR, MAIN_ROOT, WORKTREE_PATH.

How do I install finishing-a-development-branch?

Run: npx -y skills add https://github.com/obra/superpowers --skill finishing-a-development-branch --agent claude-code — the source lives at github.com/obra/superpowers.

Maintain finishing-a-development-branch?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![finishing-a-development-branch on getagentictools](https://getagentictools.com/badge/skills/obra-superpowers-finishing-a-development-branch.svg)](https://getagentictools.com/skills/obra-superpowers-finishing-a-development-branch?ref=badge)

npx agentictools info skills/obra-superpowers-finishing-a-development-branch

The second line is the CLI lookup for this page — handy in READMEs and docs.