finishing-a-development-branch

Validate tests, determine the base branch, and execute one of four finish options.

1|Updated Jan 5, 2023
One-click install
npx skills add https://github.com/riez/dots --skill finishing-a-development-branch-riez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/riez/dots/tree/main/.config/agentic/skills/finishing-a-development-branch
Command: npx skills add https://github.com/riez/dots --skill finishing-a-development-branch-riez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides teams to finish development work by validating tests, selecting a formal final workflow, and cleaning up the feature branch and worktree to maintain a clean repository.

Core Features & Use Cases

  • End-to-end finish workflow: Verifies tests, determines the base branch, and coordinates the final actions to complete a feature branch.
  • Four explicit options: Merge locally, push and create a PR, keep the branch as-is, or discard the work with clear prompts.
  • Safe cleanup and governance: Ensures worktrees and branches are cleaned up only after explicit confirmation and successful verification.
  • Use Case: When a feature branch is fully implemented and all tests pass, use this skill to finalize the work by choosing an appropriate final action and tidying up.

Quick Start

Verify tests, determine the base branch, select one of the four finish options, and complete the workflow while cleaning up worktrees.

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

Finishing a development branch requires validating tests, determining the base branch, choosing one of four workflow options, and cleaning up the worktree accordingly.

What are the standard options for finalizing a feature branch?

Finalizing a feature branch offers four explicit options: merge locally, push and create a pull request, keep the branch as-is, or discard the work entirely.

How do I clean up git worktrees after merging a feature branch?

Cleaning up worktrees happens after explicitly confirming your chosen finish workflow and verifying successful test validation, ensuring a clean repository state.

Can I discard changes on a development branch safely?

Discarding work is one of the four explicit finish options presented, allowing you to safely remove a feature branch and clean up its worktree after explicit confirmation.

Does finishing a branch require knowing the base branch alignment?

Determining the base branch is a required step in the finish workflow, ensuring your selected merge or pull request action aligns correctly with project policy.

What is the best way to manage branch completion for multiple git workflows?

Managing branch completion involves an end-to-end workflow that verifies tests, coordinates final actions across four explicit paths, and governs safe worktree cleanup.