diff options
Diffstat (limited to 'AGENTS.md')
| -rw-r--r-- | AGENTS.md | 6 |
1 files changed, 6 insertions, 0 deletions
@@ -1,5 +1,10 @@ This repo is the source of truth for bootstrapping or ratcheting Rust lint posture. +Read [docs/rust-style-doctrine.md](/home/main/programming/projects/rust_starter/docs/rust-style-doctrine.md) +before meaningful Rust style decisions. New and retrofitted Rust projects should +link to that doctrine from their own `AGENTS.md` so future agents inherit the +same taste surface. + 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). @@ -10,6 +15,7 @@ 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`. +- Install a target `AGENTS.md` link to [docs/rust-style-doctrine.md](/home/main/programming/projects/rust_starter/docs/rust-style-doctrine.md). - 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. |