finishing-a-development-branch

Validate tests, detect repository state, and execute merge, PR, or cleanup workflows.

1|Updated May 20, 2025
One-click install
npx skills add https://github.com/vessux/dotfiles --skill finishing-a-development-branch-vessux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/vessux/dotfiles/tree/main/umbel/skills/superpowers/finishing-a-development-branch
Command: npx skills add https://github.com/vessux/dotfiles --skill finishing-a-development-branch-vessux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides end-to-end completion of development work by validating progress, selecting an integration path, and cleaning up artifacts after deployment or merge.

Core Features & Use Cases

  • Verify tests pass before presenting options and proceeding with a chosen workflow.
  • Detect repository state (normal repo, named worktree, detached HEAD) to tailor the available actions.
  • Present a concise four-option workflow (or three options in detached HEAD) and execute the selected path.
  • Clean up worktrees and branches safely after successful completion, with provenance-aware cleanup.

Quick Start

Guide me through finishing my development branch by selecting a merge, PR, or cleanup path and execute the chosen workflow.

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 development branch with a guided merge or PR workflow?

To finalize a development branch, the workflow verifies tests pass, detects repository state, and presents merge, PR, or cleanup options to safely execute your selected path.

What is the best way to clean up git worktrees after merging a branch?

The best way to clean up git worktrees is through provenance-aware checks that safely remove worktrees and branches only after successful merge or deployment completion.

Can I use this workflow to finalize work in a detached HEAD state?

Yes, you can finalize work in a detached HEAD state. The workflow detects detached HEAD scenarios and presents a tailored three-option workflow to proceed safely.

Does finalizing a branch verify tests before pushing a pull request?

Yes, finalizing a branch verifies tests pass before presenting options. Test verification ensures your environment is validated before proceeding with a pull request workflow.

Why does my branch finalization workflow fail to detect named worktrees?

Branch finalization fails to detect named worktrees if repository state detection is bypassed. The workflow must properly identify normal repositories, named worktrees, and detached HEAD states.