Contributing

See the repository contributor guide.

The shortest acceptable loop is RED–GREEN–REFACTOR followed by ./scripts/check.sh. Architecture-boundary changes require an ADR or an architecture-document update and a test that proves the forbidden dependency gate can fail.

Use scoped Conventional Commits on linear main. Keep logical changes atomic so git revert is a safe rollback mechanism.

Before a release, commit the candidate and run ./scripts/package.sh. It packages and verifies every workspace crate through Cargo’s temporary local registry, including unpublished intra-workspace dependencies.