# Dart Contribute

> DART Contribute: branching, PRs, review workflow, and dual-PR bugfixes

- Skill: `dartsim/dart-contribute` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dartsim/dart-contribute`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dartsim/dart-contribute/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: dartsim (https://skillmd.com/u/dartsim)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dartsim/dart-contribute

---


<!-- AUTO-GENERATED FILE - DO NOT EDIT MANUALLY -->
<!-- Source: .claude/skills/dart-contribute/SKILL.md -->
<!-- Sync script: scripts/sync_ai_commands.py -->
<!-- Run `pixi run sync-ai-commands` to update -->

# DART Contribution Workflow

Load this skill when contributing code to DART.

## Full Documentation

For complete guide: `docs/onboarding/contributing.md`

For code style: `docs/onboarding/code-style.md`

For automated review handling: `docs/onboarding/ai-reviews.md`

## Branch Naming

- `feature/<topic>` - New features
- `fix/<topic>` - Bug fixes
- `refactor/<topic>` - Refactoring
- `docs/<topic>` - Documentation

Features, docs, and non-bugfix refactors branch from `origin/main`. Bug fixes
that apply to the current release line branch from the active DART 6 LTS
`origin/release-6.*` branch first and then reach `main` as a second PR (the
dual-PR rule in `docs/onboarding/contributing.md`).

## PR Path

Run `pixi run lint` before committing and the task-type gate set from
`docs/ai/verification.md`; use `dart-pr` for authorized local preparation and
commits. Before publication or another approval-gated action, verify existing
explicit maintainer/user approval covers its action, target, and scope; ask only
for missing authority. Use `dart-changelog` to decide the `CHANGELOG.md` entry
per `docs/onboarding/changelog.md`. Use plain descriptive
commit messages and PR titles without agent tags. Update published PR branches
with additive commits after merging the target branch; never rebase or
force-push a published PR branch unless the maintainer explicitly asks.

## Milestones (Required)

| Target Branch                          | Milestone                      |
| -------------------------------------- | ------------------------------ |
| `main`                                 | `DART 7.0` (or next major)     |
| Active DART 6 LTS `release-6.*` branch | Branch-matching DART 6.x patch |

```bash
# After explicit maintainer/user approval, set milestone on an existing PR
gh pr edit <PR#> --milestone "DART 7.0"

# List available milestones
gh api repos/dartsim/dart/milestones --jq '.[] | .title'
```