CLAUDE.md

1# CLAUDE.md
2 
3This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
4 
5## Detected stack
6- Languages: Rust.
7- Frameworks: none detected from the supported starter markers.
8 
9## Verification
10- Run Rust verification from repo root: `scripts/fmt.sh --check`; for formatting use `scripts/fmt.sh`. Run Rust clippy/tests from `rust/`: `cargo clippy --workspace --all-targets -- -D warnings`, `cargo test --workspace`
11- `src/` and `tests/` are both present; update both surfaces together when behavior changes.
12 
13## Repository shape
14- `rust/` contains the Rust workspace and active CLI/runtime implementation.
15- `src/` contains source files that should stay consistent with generated guidance and tests.
16- `tests/` contains validation surfaces that should be reviewed alongside code changes.
17 
18## Working agreement
19- Prefer small, reviewable changes and keep generated bootstrap files aligned with actual repo workflows.
20- Keep shared defaults in `.claude.json`; reserve `.claude/settings.local.json` for machine-local overrides.
21- Do not overwrite existing `CLAUDE.md` content automatically; update it intentionally when repo workflows change.
22