finishing-a-development-branch

Verify tests, determine base branch, present four options, and clean up worktrees.

205|26|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/LerianStudio/ring --skill finishing-a-development-branch-lerianstudio
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/LerianStudio/ring/tree/main/skills/finishing-a-development-branch
Command: npx skills add https://github.com/LerianStudio/ring --skill finishing-a-development-branch-lerianstudio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, gh.

What problem does it solve?

Completing development work and integrating it into the main codebase can be inconsistent, leading to broken merges, unreviewed code, or accidental data loss. This skill provides a structured completion workflow.

Core Features & Use Cases

  • Mandatory Test Verification: Ensures all tests pass before presenting integration options, preventing broken merges.
  • Structured Options: Presents exactly four clear options for integrating work: merge locally, push and create PR, keep as-is, or discard.
  • Worktree Cleanup: Integrates with using-git-worktrees to safely remove worktrees when work is complete or discarded.

Quick Start

My feature implementation is complete. Use the finishing-a-development-branch skill to integrate my 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 merge a development branch after tests pass?▼

Merging a development branch involves verifying tests pass, determining the correct base branch, and choosing between local merge, creating a pull request, keeping the branch as-is, or discarding it. This skill automates those decisions and executes the selected action via git commands.

What's the best way to integrate completed work into the main codebase?▼

Complete integration requires mandatory test verification to prevent broken merges, structured options for merging locally or via pull request, and cleanup of associated worktrees. This skill guides you through all steps after implementation finishes.

How do I clean up worktrees when finishing a development branch?▼

Worktree cleanup integrates with git worktree management to safely remove temporary worktrees across local and remote workflows when work completes or is discarded. This skill handles cleanup as part of the branch completion process.

Can I automate branch completion decisions with git and gh?▼

Yes. This skill automates the final merge or pull request workflow by determining the base branch, presenting four structured integration options, executing your selection via git and GitHub CLI, and cleaning up worktrees.

Why does my branch completion workflow lead to broken merges or unreviewed code?▼

Inconsistent completion processes skip test verification or miss base-branch context. This skill enforces mandatory test checks before integration and provides structured options—merge locally, create a pull request, keep as-is, or discard—to prevent integration failures.

Do I need a pull request or local merge to finish a development branch?▼

The choice depends on your workflow. This skill presents four options after test verification: merge locally, push and create a pull request for review, keep the branch unchanged, or discard it. You select based on your team's integration requirements.