diff options
| author | main <main@swarm.moe> | 2026-03-31 14:21:52 -0400 |
|---|---|---|
| committer | main <main@swarm.moe> | 2026-03-31 14:21:52 -0400 |
| commit | c927ac1c6e041f96326e4a32e76ca13da8f6f5be (patch) | |
| tree | 9e08adbfce36bfe2b306eb4e833807c2f799cbf3 /AGENTS.md | |
| download | rust_starter-c927ac1c6e041f96326e4a32e76ca13da8f6f5be.zip | |
Initial import
Diffstat (limited to 'AGENTS.md')
| -rw-r--r-- | AGENTS.md | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..9ea771b --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,16 @@ +This repo is the source of truth for bootstrapping or ratcheting Rust lint posture. + +Choose exactly one surface: + +- Fresh bootstrap: read [docs/bootstrap-fresh.md](/home/main/programming/projects/rust_starter/docs/bootstrap-fresh.md) and adapt the files under [template/fresh](/home/main/programming/projects/rust_starter/template/fresh). +- Retrofit: read [docs/bootstrap-retrofit.md](/home/main/programming/projects/rust_starter/docs/bootstrap-retrofit.md), then diff the target repo against [template/fresh](/home/main/programming/projects/rust_starter/template/fresh) and [docs/rust-linting-proposal.md](/home/main/programming/projects/rust_starter/docs/rust-linting-proposal.md). + +House rules: + +- Keep lint semantics in root `Cargo.toml`; keep runners, CI, and editor config orchestration-only. +- Make every member crate opt into `[lints] workspace = true`. +- Pin an exact stable toolchain in `rust-toolchain.toml`. +- Prefer `#[expect(..., reason = "...")]` for temporary local suppressions. +- Retrofit is ratchet work: preserve stricter local policy and justified local carve-outs; do not blindly paste the template. + +Use [docs/rust-linting-proposal.md](/home/main/programming/projects/rust_starter/docs/rust-linting-proposal.md) for rationale and policy details, not as a paste target. |