merging-to-main

Merge a feature branch into main with acceptance-oracle and CI-gated checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The merging-to-main skill removes uncertainty when promoting a branch to main by enforcing an acceptance-oracle check, a test-suite gate, and CI-gated PR merging with clean branch cleanup.

Core Features & Use Cases

  • Acceptance-Oracle Gate: Runs an authoritative check against a plan’s bindable Acceptance Criteria table for gate-bound tests before any PR or test work proceeds.
  • Test Suite Gate: Runs the coordinator hook test suite first, then the project’s detected test runner; blocks merge on failures unless an approved hotfix escape hatch is used.
  • Release Notes + PR Body Automation: Drafts a ship verdict and structured release notes (optionally updating CHANGELOG.md when present) and appends a demo path for user-visible merges.
  • CI Watch + Merge Safety Checks: Waits for PR checks to complete, runs a short “activity settles” gate, merges with commit history preserved, and verifies post-merge that your intended edits still exist.

Quick Start

Use the coordinator:merging-to-main skill to merge the current branch into main after its acceptance-oracle and test gates pass.

Frequently Asked Questions about merging-to-main

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I merge a feature branch into main only after tests and CI pass?

To merge a feature branch into main safely, you enforce a test-suite gate and CI-watched execution. This ensures coordinator hook tests and project tests pass first, blocking the PR merge on any failures to prevent broken releases.

What is an acceptance oracle gate for a branch merge?

An acceptance oracle gate validates a branch merge against a plan's bindable acceptance criteria table before testing. It runs an authoritative check to ensure planned requirements are met, removing uncertainty when promoting work to main.

How do I automate release notes and PR body creation for a GitHub merge?

Automate release notes and PR body creation for a GitHub merge by drafting a ship verdict and structured notes during promotion. This optionally updates CHANGELOG.md and appends a demo path for user-visible merges.

Can I override test gating to merge a hotfix into main?

Yes, you can override test gating to merge a hotfix into main using an approved hotfix escape hatch. This allows merging despite test failures when urgent release promotion is required and justified.

How do I verify a safe branch cleanup after merging a PR via gh?

To verify a safe branch cleanup after merging a PR via gh, run post-merge safety checks. This confirms your intended edits still exist in main and validates that the branch cleanup removed the merged feature branch securely.