Contributing

The repository contribution guide covers the project workflow. The design document contains the architecture and ADRs in section 9.

Before proposing a code change, run the repository’s development checks:

cargo build --workspace
cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings
cargo fmt --all --check
python3 scripts/dep-check.py

The backend build script requires Node/npm on PATH, including when Cargo builds or tests workspace crates. Documentation pages live in docs/site/src/ and can be built with mdbook build docs/site.