AGENTS.md · git:20260516.0ae823b · 2026-05-16 · sha256 45f97897e0d16b61

AGENTS.md git:20260516.0ae823bA

Immutable. This exact content is served forever at /api/v1/blob/45f97897e0d16b61.

# MANDATORY: Pre-Submit Checks for Rust Patches

**Before submitting ANY patch that touches Rust code (`*.rs`, `Cargo.toml`, `Cargo.lock`), you MUST run, in this exact order, until all three pass clean:**

1. `cargo fmt --all`
2. `cargo clippy --all-features --all-targets -- -D warnings -D clippy::panic -D clippy::unwrap_used -D clippy::expect_used`
3. `cargo check --workspace --all-targets`

Re-run after every code change. Do not silence warnings with `#[allow(...)]` unless the surrounding code already does. If a fix cannot pass these checks, report what failed — do NOT submit a known-failing patch.

External validation pipelines (clawpatch, CI) gate on `-D warnings` clippy. Patches that skip these are rejected and the work is wasted.

---
# AGENTS.md

This file provides guidance to Codex and other AI coding assistants.

For comprehensive architecture documentation, build commands, API surface, test organization, and module details, see **[CLAUDE.md](./CLAUDE.md)** — the canonical reference for this repository.