finishing-a-development-branch

Verify tests and execute merge, PR, keep, or cleanup workflows for a development branch.

3|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/DYAI2025/Stoppclock-page --skill finishing-a-development-branch-dyai2025
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/DYAI2025/Stoppclock-page/tree/main/stoppclock_speckit/.claude/commands/SKILL (27).md
Command: npx skills add https://github.com/DYAI2025/Stoppclock-page --skill finishing-a-development-branch-dyai2025

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured process for completing development work, ensuring all tests pass and offering clear options for integrating changes. It streamlines the final steps of a feature branch, from verification to merge or cleanup, saving time and preventing errors.

Core Features & Use Cases

  • Mandatory Test Verification: Ensures all tests pass before presenting integration options.
  • Structured Integration Options: Presents clear choices for merging locally, creating a Pull Request, keeping the branch, or discarding work.
  • Automated Cleanup: Handles branch deletion and worktree removal based on the chosen option.
  • Use Case: After completing a feature, use this skill to confidently merge your changes, create a PR, or clean up your workspace, knowing all necessary checks and procedures are followed.

Quick Start

1. Verify Tests: Run project's test suite. If failures, stop.

2. Determine Base Branch: Identify the branch to merge into (e.g., main).

3. Present Options:

1. Merge back to <base-branch> locally

2. Push and create a Pull Request

3. Keep the branch as-is

4. Discard this work

4. Execute Choice: Follow the steps for the selected option.

5. Cleanup Worktree: Remove the isolated worktree if applicable.

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?

Finishing a development branch involves verifying all tests pass, then choosing between four options: merge locally to your base branch, push and create a pull request, keep the branch as-is, or discard the work. The Skill automates test verification, identifies your base branch, presents these choices, executes your selection, and cleans up worktrees.

What happens if tests fail when finishing a branch?

Mandatory test verification stops the process if any tests fail. You must resolve test failures before the Skill presents integration options, ensuring only verified code proceeds to merge or PR creation.

Can I create a pull request directly from a development branch?

Yes. After tests pass, the Skill presents the option to push your branch and create a pull request as one of four workflows. It handles the base branch identification and execution automatically.

How do I clean up a development branch after merging?

Finishing a development branch includes automated cleanup that removes the branch and any associated worktrees once you select your integration option—either after a local merge, PR creation, or discarding work.

What's the difference between merging locally and creating a PR?

Local merge integrates changes directly into your base branch on your machine; creating a PR pushes the branch remotely and opens a pull request for review. The Skill presents both as distinct workflows tailored to your integration preference.

Related Skills