Install Rust style doctrine

1 files changed, 8 insertions, 1 deletions

diff --git a/skills/rust-bootstrap/SKILL.md b/skills/rust-bootstrap/SKILL.md
index 499bf04..a6d30d2 100644
--- a/skills/rust-bootstrap/SKILL.md
+++ b/skills/rust-bootstrap/SKILL.md
@@ -1,11 +1,13 @@
 ---
 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.
+description: Bootstrap or retrofit industrial-grade Rust linting and Rust style inheritance 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, ratchet an existing Rust repo toward manifest-owned lint policy, or install the canonical Rust style doctrine link into a target AGENTS.md.
 ---
 
 # Rust Bootstrap
 
 Read [AGENTS.md](/home/main/programming/projects/rust_starter/AGENTS.md) first.
+Read [docs/rust-style-doctrine.md](/home/main/programming/projects/rust_starter/docs/rust-style-doctrine.md)
+before making Rust style decisions or writing target `AGENTS.md` guidance.
 
 Then choose exactly one surface.
 
@@ -16,6 +18,7 @@ Use this when the target repo is blank or when you are setting up Rust linting f
 Read:
 
 - [docs/bootstrap-fresh.md](/home/main/programming/projects/rust_starter/docs/bootstrap-fresh.md)
+- [docs/rust-style-doctrine.md](/home/main/programming/projects/rust_starter/docs/rust-style-doctrine.md)
 - [template/fresh](/home/main/programming/projects/rust_starter/template/fresh)
 
 Apply the template deliberately:
@@ -24,6 +27,7 @@ Apply the template deliberately:
 - keep repo-wide policy in root `Cargo.toml`
 - keep `clippy.toml` tiny or delete it
 - keep runners thin and orchestration-only
+- create or adapt target `AGENTS.md` so it links to the canonical Rust style doctrine
 
 ## Retrofit
 
@@ -34,6 +38,7 @@ 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)
+- [docs/rust-style-doctrine.md](/home/main/programming/projects/rust_starter/docs/rust-style-doctrine.md)
 
 Retrofit is diff-aware ratchet work:
 
@@ -42,10 +47,12 @@ Retrofit is diff-aware ratchet work:
 - preserve justified local exceptions
 - move duplicated script or CI flags into manifest-owned policy
 - delete duplicate policy copies only after the manifest is authoritative
+- add or preserve a target `AGENTS.md` link to the canonical Rust style doctrine
 
 ## Guardrails
 
 - Re-open the repo docs when details matter; do not rely on memory.
+- Install style inheritance through target `AGENTS.md`; do not assume future agents will remember this skill.
 - 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.