القائمة
Create or reorganize Rust modules following the remu Module Declaration Constitution. Use when adding a new .rs file, moving files, or fixing bare mod violations.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | module-setup |
| description | Create or reorganize Rust modules following the remu Module Declaration Constitution. Use when adding a new .rs file, moving files, or fixing bare mod violations. |
Every crate MUST declare its modules exclusively through remu_macro macros. Manual mod / pub mod / pub use for module plumbing is forbidden.
| Directory shape | Macro | Generated code |
|---|---|---|
src/X.rs (same-dir file) | mod_flat!(X) | mod X; pub use X::*; |
src/X/mod.rs (sub-dir) | mod_pub!(X) | pub mod X; |
src/X.rs (file, needs path access) | mod_pub_flat!(X) | pub mod X; pub use X::*; |
mod_flat!, mod_pub!, mod_pub_flat!) appears at most once per file. Merge same-type calls.mod_flat! + one mod_pub! is fine.mod func3 { ... }, mod tests { ... } don't need macros.as alias exception: pub use LongName as Short; is OK after mod_pub!.pub/pub(crate); mod_flat! exports only pub items.src/new_file.rsmod_flat! call in lib.rs (or mod.rs for sub-modules)mod_flat! exists yet, create one: remu_macro::mod_flat!(new_file);src/new_module/mod.rsmod_pub! callmod_pub! exists, create one: remu_macro::mod_pub!(new_module);src/prelude.rsremu_macro::mod_pub_flat!(prelude); — this replaces both pub mod prelude; and pub use prelude::*;mod_pub! for same-directory files → should be mod_flat!mod X; without macro → violationpub use X::*; when mod_flat! already does it → redundantmod_flat! calls instead of one merged call → violation of single-call-per-typeremu_macro/src/lib.rs uses bare mod module; mod pattern; — this is the ONLY allowed exception (bootstrap problem: the macros are defined inside those modules).
Create or maintain a lazy-built native .so library that is hash-checked and dlopen'd at runtime, following the spike / nzea pattern. Use when adding a new simulator backend or external C/C++ dependency that should not block cargo build.
Create or update flow/ directories (command.rs, option.rs, generic.rs) for crates that need data-flow conventions. Use when a crate needs runtime commands, initialization options, or compile-time generic configuration.
Add a new ISA variant (e.g., RV64I, RV32IMF) to the project. Covers updating the for_each_isa! table, dispatch macros, and IsaKind enums across remu_isa, remu_harness, remu_simulator_nzea, and remu_boot.
Scaffold a new Rust crate in the remu workspace following all conventions. Use when creating a new library crate, simulator backend, or utility crate.