finishing-a-development-branch

Verify tests and present four git integration options with worktree cleanup.

9|2|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/DmitriyPolukhin/antigravity-superpower --skill finishing-a-development-branch-dmitriypolukhin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/DmitriyPolukhin/antigravity-superpower/tree/main/modules/finishing-a-development-branch
Command: npx skills add https://github.com/DmitriyPolukhin/antigravity-superpower --skill finishing-a-development-branch-dmitriypolukhin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents broken or unverified changes from being merged by forcing you to confirm test success and then choose a clean, explicit next integration workflow.

Core Features & Use Cases

  • Test-first completion gate: Verifies the project test suite before presenting any merge/PR/discard options.
  • Structured integration choices: Presents exactly four integration paths (local merge, PR, keep branch, or discard with confirmation).
  • Worktree cleanup control: Removes the worktree for merge/discard flows while preserving it for “keep as-is”.

Quick Start

Use the finishing-a-development-branch skill when your implementation is complete and you want to decide between merging, opening a pull request, preserving the branch, or discarding it.

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

To safely complete a git branch, this workflow runs your project test suite as a gate before presenting any integration options. You must confirm test success to proceed with a local merge, pull request, keep, or discard workflow.

What are my options for finishing a development branch after tests pass?

After test verification passes, you get exactly four concise options: local merge, create a pull request, keep the branch as-is, or discard it. Discarding requires typed confirmation to prevent accidental data loss.

How does git worktree cleanup work when discarding or merging a branch?

Git worktree cleanup automatically removes the worktree when you choose to merge or discard the branch. If you choose to keep the branch as-is, the worktree is preserved so you can continue working in that isolated directory.

Can I open a pull request without discarding my local git worktree?

Yes, when you select the pull request option to finish your development branch, the workflow handles the PR creation while preserving your local worktree. Worktree removal only occurs for the local merge and discard flows.

What is the best way to prevent broken code from being merged into the release workflow?

The best way to prevent broken code in your release workflow is enforcing a test-first completion gate. This ensures the project test suite passes and requires explicit confirmation before allowing any branch integration or merge to proceed.