- Read
AGENTS.mdbefore making non-trivial changes. - Follow relevant files under
context/andskills/. - Keep changes small, test-backed, and architecture-aligned.
Run before opening a PR:
cargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
scripts/validate_openapi_live.shInstall project hooks:
python3 -m venv .venv
source .venv/bin/activate
python -m pip install pre-commit openapi-spec-validator==0.7.2
pre-commit install --hook-type pre-commit --hook-type pre-pushUpdate docs when behavior changes:
README.mdfor user-facing behavior.docs/ARCHITECTURE.mdfor system/model changes.context/files for workflow or readiness changes.