- Create a focused branch.
- Make scoped changes with tests/docs updates where relevant.
- Run local validation:
mise run formatmise run lintmise run testmise run health
- Open a PR using
.github/pull_request_template.md.
- Follow
AGENTS.mdas the source-of-truth contract. - Keep edits limited to requested scope; do not touch unrelated files.
- Report exact validation commands run and pass/fail status.
- Escalate when behavior/API compatibility changes are required.
mise run docs validates the manually maintained release docs surface
(README.md + doc/commentry.txt help tags/public command coverage). If a
change affects user-facing behavior, update those docs directly and rerun the
docs task.