diff options
Diffstat (limited to 'skills/rust-bootstrap')
| -rw-r--r-- | skills/rust-bootstrap/SKILL.md | 53 | ||||
| -rw-r--r-- | skills/rust-bootstrap/agents/openai.yaml | 4 |
2 files changed, 57 insertions, 0 deletions
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. diff --git a/skills/rust-bootstrap/agents/openai.yaml b/skills/rust-bootstrap/agents/openai.yaml new file mode 100644 index 0000000..2dbdc72 --- /dev/null +++ b/skills/rust-bootstrap/agents/openai.yaml @@ -0,0 +1,4 @@ +interface: + display_name: "Rust Bootstrap" + short_description: "Bootstrap or tighten Rust linting" + default_prompt: "Use rust_starter to bootstrap or retrofit industrial-grade Rust linting." |