Thanks for helping with cutils. This file covers the short path from clone to a mergeable PR.
Requires node 22 or newer and pnpm (the exact version is pinned in packageManager). Use pnpm only, never npm.
pnpm install
pnpm -r buildpnpm lintruns oxlint,pnpm fmtruns oxfmt.pnpm testruns every workspace test. Any behavior change ships with tests.scripts/scriptc-gate.sh(afterpnpm -r build) fails unless everypackages/*/gate.tscompiles 100% static underscriptc coverage. Read the subset rules inAGENTS.mdbefore touchingpackages/*/src.pnpm smoke:packpacks every package and asserts the tarballs install and resolve.- Performance claims need a bench cell first; v1 packages ship without perf claims.
Every change that touches packages/* records an intent with pnpm change, naming the affected packages, the bump type and a one line summary that becomes the changelog entry. Commit the intent file with the change. If a change needs no release, record it with --bump none. pnpm change check validates intents and versions.
Use conventional commits and keep them atomic: one logical change per commit. Link the PR to its issue. Do not add co-author trailers.
Feature work starts from a plan in .agents/plans/<date>-<purpose>.md (see .agents/backlog-policy.md).
Maintainers only. See RELEASING.md. Releases are packed and published with pnpm, never npm.