# Contributing

## Design first

Open an issue describing the change you want to make and why. A maintainer
reads it and, once the approach is agreed, adds the `design-approved` label to
the issue. Then open the pull request with `Closes #N` in the description.

The `design-gate` check enforces this: a PR without a linked, `design-approved`
issue cannot be reviewed or merged, and a PR marked ready for review too early
is put back into draft until the label lands. When the label is applied, the
waiting PR is marked ready for review automatically.

Draft PRs are welcome at any time as proposals — open one whenever showing code
is the clearest way to make the point. It stays a draft until its issue is
approved.

Typo-class fixes do not need an issue. Open the PR; a maintainer applies the
`trivial` label to it and the gate stands down.

## Before you push

Run `bun run format` and `cargo fmt`. CI rejects unformatted code.