skills.rest
Arcanada-one
Arcanada-oneOFFICIAL
Explore all skills by this author →
WebsiteGitHub

finishing-a-development-branch

Verify the test suite and choose the correct Git integration action.

11|1|Updated Apr 10, 2026
Search Tags:#git#testing#pull request#branch management#merge#release workflow#worktree cleanup
One-click install
npx skills add https://github.com/Arcanada-one/datarim --skill finishing-a-development-branch-arcanada-one
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/Arcanada-one/datarim/tree/main/skills/finishing-a-development-branch
Command: npx skills add https://github.com/Arcanada-one/datarim --skill finishing-a-development-branch-arcanada-one

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents broken or premature integration by ensuring tests pass, then guiding you to merge locally, open a PR, keep the branch, or safely discard it.

Core Features & Use Cases

  • Test-first completion gate: blocks merge/PR options when the test suite fails, forcing verification before integration.
  • Environment-aware workflow: detects whether you are in a normal repo, named worktree branch, or a detached HEAD and shows the correct option set.
  • Safe cleanup and branch lifecycle: cleans up only for local-merge or discard paths, and avoids deleting worktree/branches in unsafe order.
  • Choice execution with guardrails: offers structured actions for merging to a base branch, pushing and creating a PR, preserving for later iteration, or requiring typed confirmation for deletion.

Quick Start

Use the finishing-a-development-branch skill when your changes are ready and tests have passed, so it can guide you to merge locally, push a PR, keep the branch, or discard it safely.

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 finish a git branch and decide between merging or creating a pull request?▼

To finish a git branch safely, run the test suite first to verify it passes, then choose between a local merge, pushing a pull request, preserving the branch, or discarding it based on your workflow needs.

What happens if my test suite fails before a git merge or pull request?▼

If your test suite fails before a git merge or pull request, the completion gate blocks integration options and forces you to fix the failing tests before proceeding with any branch finishing actions.

Can I finish a development branch if I am in a detached HEAD state?▼

Yes, you can finish a development branch in a detached HEAD state because the workflow detects your Git environment and presents the correct option set for safe integration or discard actions.

What is the best way to clean up git worktrees after a successful branch merge?▼

The best way to clean up git worktrees after a branch merge is to remove only owned scratch worktrees, ensuring safe cleanup that avoids deleting branches or worktrees in an unsafe order.

How do I safely discard a git development branch without breaking the main repository?▼

To safely discard a git development branch, use a workflow that requires typed confirmation for deletion, ensuring the branch is removed only after explicit consent and without affecting unrelated worktrees.

Related Skills

Explore More Software Engineering Skills→
TumeloRamaphosaTumeloRamaphosa

finishing-a-development-branch

Finish Git feature branches with merge, pull request, keep, or discard options.

Community
Intermediate
Conceptual-MachinesConceptual-Machines
195

release

Create and push a v-prefixed git tag on the main branch.

Official
Intermediate
RoxabiRoxabi
9

promote

Automate staging-to-main branch promotion with pre-flight checks, versioning, and pull request creation.

Official
Advanced
nikhilsitaramnikhilsitaram
89

pr-merge

Merge reviewed GitHub pull requests and clean up branches and worktrees.

Community
Advanced