skills.rest
JoeCP17
JoeCP17COMMUNITY
Explore all skills by this author →
WebsiteGitHub

finishing-a-development-branch

Validate tests and present four git integration options for a development branch.

8|1|Updated Mar 1, 2026
Search Tags:#git#pull request#branch management#test verification#merge workflow#release readiness#worktree cleanup
One-click install
npx skills add https://github.com/JoeCP17/LLM-Dot-files --skill finishing-a-development-branch-joecp17
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/JoeCP17/LLM-Dot-files/tree/main/claude/skills/superpowers/finishing-a-development-branch
Command: npx skills add https://github.com/JoeCP17/LLM-Dot-files --skill finishing-a-development-branch-joecp17

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finishing a feature or development branch is risky when tests are unchecked or when the next integration step is ambiguous, leading to broken merges or unclear PR outcomes.

Core Features & Use Cases

  • Test-gated completion: Runs the project test suite first and stops immediately if failures are detected, preventing accidental merges or PRs.
  • Deterministic integration options: Guides you through exactly four next-step choices—merge locally, open a PR, keep the branch, or discard it—so the workflow stays unambiguous.
  • Safe cleanup with worktree awareness: Performs controlled worktree cleanup for merge/PR/discard cases (without deleting data when keeping the branch).

Use case: You finish implementing a backend feature and want to decide whether to merge into main, open a GitHub PR, preserve the branch for later iteration, or safely discard it after confirming test success.

Quick Start

Use the finishing-a-development-branch skill to verify tests and then present the four integration choices for the current feature branch, stopping if any tests fail.

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 verify tests before merging a git branch?▼

To verify tests before merging a git branch, this skill runs the project test suite first and immediately stops if failures are detected, preventing accidental merges or broken pull requests.

What is the best way to choose between a local merge and opening a pull request?▼

Choosing between a local merge and opening a pull request is handled by presenting exactly four structured integration options after tests pass, including merging locally, opening a PR, keeping the branch, or discarding it.

How do I safely discard a git branch after finishing development?▼

To safely discard a git branch after finishing development, this skill enforces a typed confirmation step before deletion, ensuring the worktree cleanup only occurs after explicit user consent.

Does git worktree cleanup run if I keep my branch for later iteration?▼

Git worktree cleanup does not run if you keep your branch for later iteration, as the cleanup operation is strictly limited to the merge, pull request, and discard paths to preserve branch data.

When do I need test pass verification for a release readiness workflow?▼

Test pass verification for a release readiness workflow is needed whenever you finish implementing a feature, ensuring the development work concludes safely before any git integration action is orchestrated.

Can I use this skill to manage ambiguous branch management workflows?▼

You can use this skill to manage ambiguous branch management workflows by guiding you through deterministic next-step choices, so the integration process stays unambiguous and strictly completion-focused.

Related Skills

Explore More Software Engineering Skills→
Sheldon-92Sheldon-92
3

Testing

Execute test suites and report failures with coverage metrics.

Community
Intermediate
jkomorosjkomoros
9

git-workflow

Automate Git rebases, conflict resolution, and pull request creation with gh pr.

Community
Intermediate
jeffhjeffh
12

create-worktree

Create isolated git or jj worktrees with branch management and setup.

Community
Advanced
mouseqiao85mouseqiao85
1

finishing-a-development-branch

Verify tests, detect workspace state, and present Git merge options.

Community
Advanced