finishing-a-development-branch

Verify tests and present three branch completion options.

5|2|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/dbc-oduffy/coordinator-claude --skill finishing-a-development-branch-dbc-oduffy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/dbc-oduffy/coordinator-claude/tree/main/plugins/coordinator/skills/finishing-a-development-branch
Command: npx skills add https://github.com/dbc-oduffy/coordinator-claude --skill finishing-a-development-branch-dbc-oduffy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents broken or unreviewable changes from being merged by enforcing test verification and offering a clear, bounded completion workflow for a development branch.

Core Features & Use Cases

  • Acceptance-oracle advisory check: Runs an early, non-authoritative gate-bound test oracle when a plan path is available, and records findings without blocking.
  • Authoritative test verification: Fails fast if the project test suite does not pass, blocking merge/PR completion until green.
  • Deterministic end-of-workflow options: Presents exactly three next actions—merge via PR (recommended), create a PR without merging, or keep the branch as-is—with worktree cleanup only for the merge path.

Quick Start

Use finishing-a-development-branch to complete your branch after implementation and tests are expected to be green, then choose whether to merge via PR, open a PR only, or keep the branch for later.

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 verify tests before merging a git development branch?▼

To verify tests before merging a git development branch, this workflow runs your project test suite and hard-blocks completion if tests fail, ensuring only passing changes move forward.

What are my options for finishing a development branch after implementation?▼

When finishing a development branch, you get exactly three deterministic options: merge to main via a pull request, create a pull request without merging, or keep the branch as-is for later review.

Does this branch completion workflow run CI checks or test oracles?▼

Yes, the branch completion workflow runs CI checks by executing your project test suite as an authoritative gate, and optionally runs an advisory acceptance-oracle if a plan path is available.

When is worktree cleanup performed during a git merge to main?▼

Worktree cleanup is performed only when you select the merge via pull request option to finalize your release workflow; the other two branch completion paths preserve your working state.

Can I keep a development branch as work in progress instead of creating a pull request?▼

Yes, you can keep a development branch as-is instead of creating a pull request, which parks your work safely for later review without triggering worktree cleanup or a merge to main.