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.