From c927ac1c6e041f96326e4a32e76ca13da8f6f5be Mon Sep 17 00:00:00 2001 From: main Date: Tue, 31 Mar 2026 14:21:52 -0400 Subject: Initial import --- skills/rust-bootstrap/SKILL.md | 53 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 skills/rust-bootstrap/SKILL.md (limited to 'skills/rust-bootstrap/SKILL.md') diff --git a/skills/rust-bootstrap/SKILL.md b/skills/rust-bootstrap/SKILL.md new file mode 100644 index 0000000..499bf04 --- /dev/null +++ b/skills/rust-bootstrap/SKILL.md @@ -0,0 +1,53 @@ +--- +name: rust-bootstrap +description: Bootstrap or retrofit industrial-grade Rust linting by using the `rust_starter` repo as the source of truth. Use when Codex needs to set up strict Rust lint/check posture from scratch in a new repo, or ratchet an existing Rust repo toward manifest-owned lint policy without blindly overwriting valid local exceptions or stricter existing rules. +--- + +# Rust Bootstrap + +Read [AGENTS.md](/home/main/programming/projects/rust_starter/AGENTS.md) first. + +Then choose exactly one surface. + +## Fresh Bootstrap + +Use this when the target repo is blank or when you are setting up Rust linting from scratch. + +Read: + +- [docs/bootstrap-fresh.md](/home/main/programming/projects/rust_starter/docs/bootstrap-fresh.md) +- [template/fresh](/home/main/programming/projects/rust_starter/template/fresh) + +Apply the template deliberately: + +- replace placeholder members, names, and version/toolchain values +- keep repo-wide policy in root `Cargo.toml` +- keep `clippy.toml` tiny or delete it +- keep runners thin and orchestration-only + +## Retrofit + +Use this when the target repo already has Rust linting or check scripts and needs tightening. + +Read: + +- [docs/bootstrap-retrofit.md](/home/main/programming/projects/rust_starter/docs/bootstrap-retrofit.md) +- [template/fresh](/home/main/programming/projects/rust_starter/template/fresh) +- [docs/rust-linting-proposal.md](/home/main/programming/projects/rust_starter/docs/rust-linting-proposal.md) + +Retrofit is diff-aware ratchet work: + +- do not paste the fresh template wholesale +- preserve stricter local policy +- preserve justified local exceptions +- move duplicated script or CI flags into manifest-owned policy +- delete duplicate policy copies only after the manifest is authoritative + +## Guardrails + +- Re-open the repo docs when details matter; do not rely on memory. +- Use [docs/rust-linting-proposal.md](/home/main/programming/projects/rust_starter/docs/rust-linting-proposal.md) for rationale, not as a paste target. +- If a target repo already exceeds the template in some area, keep the stricter local posture. +- If a target repo intentionally diverges, adapt the pattern instead of forcing uniformity. + +This skill is intentionally thin. The repo docs are the real payload. -- cgit v1.2.3