finishing-a-development-branch

Enforce test success before merging, PR creation, or discarding feature branches.

8|5|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/axiomantic/spellbook --skill finishing-a-development-branch-axiomantic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/axiomantic/spellbook/tree/main/skills/finishing-a-development-branch
Command: npx skills add https://github.com/axiomantic/spellbook --skill finishing-a-development-branch-axiomantic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineers decide how to integrate completed work from a feature branch, ensuring tests pass, avoiding risky merges, and providing clear options for merging, PR creation, keeping, or discarding work.

Core Features & Use Cases

  • Enforce tests as a gate before integration.
  • Provide four structured options: merge locally, push+PR, keep branch, or discard.
  • Handle worktree lifecycle accordingly and request explicit discard confirmation.

Quick Start

Run the test suite, determine the base branch, and choose one of four actions to finalize the work.

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 git development branch after tests pass?

To finalize a git development branch, you enforce test success as a gate and select a structured integration option: merge locally, push and create a PR, keep the branch, or discard the work.

What is the best way to merge a feature branch while avoiding risky integrations?

The best way to merge a feature branch safely is to detect the base branch, run tests to gate integration, and choose an explicit lifecycle action like a local merge or PR to finalize the work.

How do I manage git worktree lifecycle when discarding a feature branch?

To manage git worktree lifecycle when discarding a feature branch, the workflow handles the worktree cleanup and requires explicit discard confirmation before removing the completed or abandoned work.

Can I create a pull request directly after my test suite passes?

Yes, you can create a pull request by selecting the push and PR option after the test suite passes the gating check and the base branch is detected for the development branch.

What are the options for integrating a completed development branch?

The four options for integrating a completed development branch are merging locally, pushing to create a PR, keeping the branch active, or discarding the work with explicit confirmation.

Why should I gate branch merges with test success before finalizing?

You should gate branch merges with test success to ensure complete work passes tests before integration, preventing risky merges and ensuring only validated code reaches the base branch.