finishing-a-development-branch

Verify tests pass and choose merge, PR, keep, or discard for a finished branch.

17|Updated Oct 13, 2025
One-click install
npx skills add https://github.com/cipherstash/cipherpowers --skill finishing-a-development-branch-cipherstash
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/cipherstash/cipherpowers/tree/main/plugin/skills/finishing-a-development-branch
Command: npx skills add https://github.com/cipherstash/cipherpowers --skill finishing-a-development-branch-cipherstash

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates ambiguity and potential errors when completing development work by providing a structured, test-verified process for integrating code changes.

Core Features & Use Cases

  • Test-First Verification: Ensures all tests pass before proceeding with any integration workflow.
  • Structured Completion Options: Presents exactly four clear choices for handling completed work.
  • Safe Cleanup: Automatically manages worktree cleanup based on the selected option.
  • Use Case: After implementing a new feature and running all tests successfully, use this Skill to choose between merging locally, creating a PR, keeping the branch, or discarding the work with proper confirmation.

Quick Start

Use the finishing-a-development-branch skill to complete my current development work and present the four integration options.

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 merge a finished development branch into my main codebase?

Merging a finished development branch requires test verification first, then choosing between local merge, pull request, keeping the branch, or discarding it. This Skill enforces passing tests before presenting four structured integration options with exact commands and cleanup steps for each path.

What's the best way to handle branch cleanup after completing development work?

Branch cleanup depends on your chosen integration workflow. After tests pass, this Skill provides safe cleanup procedures tailored to each option: local merge, PR creation, branch retention, or deletion, with automatic worktree management.

How do I decide between merging locally, creating a pull request, or keeping my development branch?

After implementing features and running all tests successfully, this Skill presents exactly four clear choices: merge locally to base branch, push a PR for review, keep the branch active, or discard with confirmation, helping you pick the right path for your workflow.

Why should I verify tests before integrating a development branch?

Test verification before branch integration catches errors early and prevents broken code from reaching production or shared branches. This Skill enforces passing tests as a prerequisite, ensuring code quality before presenting integration options.

Can this workflow detect my base branch automatically?

Yes, this Skill includes base-branch detection that identifies the target branch for integration, eliminating manual configuration and reducing errors when merging or creating pull requests from development work.

What happens if tests fail before I complete my development branch?

If tests fail, this Skill does not present integration options. You must fix failing tests first and re-run verification before the workflow allows you to proceed with any merge, PR, or cleanup action.