swarm repositories / source
aboutsummaryrefslogtreecommitdiff
path: root/AGENTS.md
diff options
context:
space:
mode:
Diffstat (limited to 'AGENTS.md')
-rw-r--r--AGENTS.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..0c1da24
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,20 @@
+# AGENTS.md
+
+Before meaningful Rust edits, read the [Rust Style Doctrine](/home/main/programming/projects/rust_starter/docs/rust-style-doctrine.md).
+It intentionally rejects several pieces of conventional Rust advice; preserve
+those inversions instead of translating them back into generic approachable
+code.
+
+Local rules:
+
+- The only permitted child/subagent is `clippy_fixer`, and only for
+ `$clippy-fix`. Do not invoke any other agent kind.
+- Prefer explicit domain types, enums, newtypes, and total transforms over
+ stringly state, bool flags, and ad-hoc tuples.
+- Use `rust-analyzer` before textual search when you need definitions,
+ references, diagnostics, or refactors.
+- Default to deletion over backward-compatibility shims when the task does not
+ explicitly require compatibility.
+- Run `cargo fmt` after meaningful edits.
+- Run `./check.py check` after meaningful local edits. Use `./check.py verify`
+ for a non-mutating CI-style gate.