swarm repositories / source
aboutsummaryrefslogtreecommitdiff
path: root/skills
diff options
context:
space:
mode:
Diffstat (limited to 'skills')
-rw-r--r--skills/rust-bootstrap/SKILL.md9
-rw-r--r--skills/rust-bootstrap/agents/openai.yaml4
2 files changed, 10 insertions, 3 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.
diff --git a/skills/rust-bootstrap/agents/openai.yaml b/skills/rust-bootstrap/agents/openai.yaml
index 2dbdc72..6a4010a 100644
--- a/skills/rust-bootstrap/agents/openai.yaml
+++ b/skills/rust-bootstrap/agents/openai.yaml
@@ -1,4 +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."
+ short_description: "Bootstrap Rust linting and style inheritance"
+ default_prompt: "Use rust_starter to bootstrap or retrofit industrial-grade Rust linting and install the Rust style doctrine link."