Rust Modern Modules
Developmentrust-modern-modulesRust Modern Modules is an Agent Skill for development published in the AkimioJR/AutoFilm repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Enforce modern Rust module file layout. Use when Codex creates, splits, moves, or refactors Rust modules, especially when deciding between `mod.rs` and `foo.rs` plus `foo/bar.rs` layouts.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/AkimioJR/AutoFilm/blob/HEAD/.agents/skills/rust-modern-modules/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/rust-modern-modules, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Rust Modern Modules
Rule
Prefer Rust 2018+ module layout:
src/foo.rs
src/foo/bar.rs
Use this from src/foo.rs:
mod bar;
Do not create src/foo/mod.rs for new modules unless the repository already consistently uses mod.rs in that area or the user explicitly asks for it.
Workflow
- Inspect nearby Rust modules before creating files.
- If both layouts are viable, choose
foo.rsas the parent module andfoo/*.rsfor children. - If refactoring an existing
mod.rs, avoid moving it unless the user asked for a layout cleanup or the move is necessary for the task. - Keep module declarations private by default: use
mod child;first, then widen topub mod child;only when external access is needed. - Run
cargo fmtafter moving or creating Rust module files.
Examples
For a logging module with a daily appender, prefer:
src/logging.rs
src/logging/daily_file_appender.rs
Inside src/logging.rs:
mod daily_file_appender;
use daily_file_appender::DailyFileAppender;