finishing-a-development-branch

Verify tests and merge, push, preserve, or discard git feature branches.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/zephyrflow97/cadence --skill finishing-a-development-branch-zephyrflow97
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/zephyrflow97/cadence/tree/main/skills/finishing-a-development-branch
Command: npx skills add https://github.com/zephyrflow97/cadence --skill finishing-a-development-branch-zephyrflow97

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes ambiguity and risk when finishing work on a feature branch by enforcing test verification, presenting clear integration choices, and performing the chosen merge, PR, preservation, or discard workflow with appropriate confirmations and cleanup.

Core Features & Use Cases

  • Automated Test Verification: Runs or instructs verification of the project's test suite and blocks progression if tests fail.
  • Structured Decision Flow: Presents exactly four concise options (merge locally, push and create PR, keep branch, discard work) to avoid ambiguous next steps.
  • Safe Execution and Cleanup: Performs merges, pushes, PR creation guidance, forced deletes only with typed confirmation, and removes git worktrees when appropriate.
  • Use Case: Finalize a completed implementation by verifying tests, creating a PR with a summary and test plan, and cleaning up the local worktree to leave the repository tidy.

Quick Start

Run the finishing-a-development-branch skill and choose whether to merge, create a PR, keep, or discard the branch after tests pass.

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 finish a git feature branch and create a pull request?

Finishing a git feature branch involves verifying tests pass, choosing to merge or create a pull request, and cleaning up the worktree. This process enforces test verification before allowing integration and safely removes the local worktree afterward.

What should I do before merging a development branch back to the base branch?

Before merging a development branch, run the project's test suite to ensure all tests pass. The workflow blocks progression if verification fails, then determines the correct base branch and executes the merge only after explicit confirmation.

Can I discard changes and delete a git worktree safely?

Yes, you can discard work and delete a git worktree safely by selecting the discard option. This action requires typed confirmation before executing forced deletes and removing the worktree, preventing accidental data loss during branch cleanup.

How do I clean up git worktrees after a successful branch merge?

To clean up git worktrees after a branch merge, select the local merge option during the workflow. Once the merge is confirmed and executed, the process automatically removes the associated worktree to leave the repository tidy.

What are my options for integrating a completed feature branch?

When a feature branch is complete and tests pass, your integration options are merge locally, push and create a pull request, keep the branch for further work, or discard the work entirely. Each option includes appropriate cleanup and confirmation steps.

Why does my branch integration fail when tests do not pass?

Branch integration fails when tests do not pass because automated test verification blocks progression. This enforcement ensures that only verified code with a passing test suite can be merged, pushed for a pull request, or otherwise integrated into the base branch.