dart-release-merge-main

SkillDev tools

DART Release Merge Main: merge the active release branch back into main

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the dart-release-merge-main skill

What this skill tells your AI

The instructions your AI receives, as published by dartsim/dart in .agents/skills/dart-release-merge-main/SKILL.md and read by ahel’s review.

Use this skill in Codex to run the DART dart-release-merge-main workflow. The editable workflow source lives in .claude/commands/; this file is its generated adapter in the shared .agents/skills/ catalog.

Invocation

  • Claude Code/OpenCode: /dart-release-merge-main <arguments>
  • Codex: $dart-release-merge-main <arguments>

Treat the text after the skill name as $ARGUMENTS. When the workflow references $1, $2, etc., map those to the positional values supplied by the user.

Command Body

Merge release branch into main: $ARGUMENTS

Required Reading

@AGENTS.md @docs/onboarding/release-management.md @docs/onboarding/ci-cd.md

Workflow

  1. Auto-detect or confirm the active release branch and release version:
    git fetch origin
    git branch -r | grep -oE 'origin/release-[0-9]+\.[0-9]+' | sort -V | tail -1
    
  2. Verify the clone is not shallow and a merge base exists.
  3. Create merge/<release-branch>-into-main from origin/main.
  4. Merge the release branch with a title like Merge release-6.20 into main (v6.20.x).
  5. Resolve conflicts using docs/onboarding/release-management.md:
    • deleted in main, updated in release: keep deleted
    • added in both: prefer main unless release has unique needed content
    • content conflicts: prefer main modernization except for manually reviewed changelog entries
    • files only on release: keep if still relevant to main
  6. Verify no unresolved conflicts remain.
  7. Run pixi run lint and relevant checks.
  8. Ask for explicit maintainer/user approval before pushing or creating the PR. After approval, create a PR targeting main with milestone DART 7.0 and use the PR template.
  9. Monitor CI until green.

Output

  • PR URL and CI status
  • Release branch and release version
  • Conflict counts and resolution summary
  • Any manual changelog decisions

Signals

GitHub stars
1k
Forks
304
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
dart-release-merge-main
Source
github.com/dartsim/dart