# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Status

Freshly scaffolded Rust binary crate (edition 2024). `src/main.rs` is still the `cargo new` "Hello, world!" stub and `Cargo.toml` has no dependencies yet. There is no architecture to document — update this file as real structure emerges.

## Commands

```bash
cargo build              # build
cargo run                # run the binary
cargo test               # run all tests
cargo test <name>        # run a single test by name substring
cargo +nightly fmt       # format — always nightly, not stable
cargo clippy             # lint before committing
```

## Conventions

- **CLI args & env vars:** use `clap` with the `derive` feature.
- **Code navigation:** prefer the insikt LSP server over grep/glob — it resolves macro-generated symbols that text search misses. (insikt runs standalone, not via the gateway MCP.)
- **Dependencies:** manage via the `cargo-mcp` server rather than editing `Cargo.toml` by hand.
- **Formatting:** `cargo +nightly fmt` (nightly toolchain required).