Before writing any new code it requires a DRY check against src/core/services and src/core/traits. See solid-principles.md for the overview, the per-principle references for SRP/OCP/LSP/ISP/DIP detail, and the templates for module/service/trait/handler/error/test scaffolding.
SOLID Rust - Modular Architecture
Agent Workflow (MANDATORY)
Before ANY implementation, spawn 3 agents in parallel, one Agent call each with a name:
- fuse-ai-pilot:explore-codebase - Analyze existing architecture
- fuse-ai-pilot:research-expert - Verify Rust docs via Context7
- fuse-ai-pilot:sniper - Post-implementation validation
DRY - Reuse Before Creating (MANDATORY)
Before writing ANY new code:
- Grep the codebase for similar traits, services, or logic
- Check shared locations:
src/core/services/, src/core/traits/
- If similar code exists -> extend/reuse instead of duplicate
- If code will be used by 2+ features -> create it in
src/core/
Architecture (Modules MANDATORY)
| Layer |
Location |
Max Lines |
| Handlers |
src/modules/[feature]/handlers.rs |
50 |
| Services |
src/modules/[feature]/services.rs |
100 |
| Repositories |
src/modules/[feature]/repository.rs |
100 |
| Traits |
src/modules/[feature]/traits.rs |
30 |
| Models |
src/modules/[feature]/models.rs |
50 |
| Shared |
src/core/{services,traits,models}/ |
- |
NEVER use flat src/ structure - always src/modules/[feature]/
Critical Rules (MANDATORY)
| Rule |
Value |
| File limit |
100 lines (split at 90) |
| Handlers |
< 50 lines, delegate to services |
| Traits |
traits.rs or src/core/traits/ ONLY |
| Rustdoc |
/// on every public item |
| Error handling |
Use thiserror for custom errors |
| Generics |
Use trait bounds, not concrete types |
Reference Guide
Concepts
| Topic |
Reference |
When to consult |
| SOLID Overview |
solid-principles.md |
Quick reference |
| SRP |
single-responsibility.md |
Fat structs |
| OCP |
open-closed.md |
Adding impls |
| LSP |
liskov-substitution.md |
Trait contracts |
| ISP |
interface-segregation.md |
Fat traits |
| DIP |
dependency-inversion.md |
Generics/DI |
| Architecture |
architecture-patterns.md |
Modular crate |
Templates
| Template |
When to use |
| module.md |
Feature module structure |
| service.md |
Business logic service |
| trait-def.md |
Trait definition |
| handler.md |
HTTP handler (Axum) |
| error.md |
Custom errors (thiserror) |
| test.md |
Unit + integration tests |
Forbidden
| Anti-Pattern |
Fix |
| Files > 100 lines |
Split at 90 |
| Traits in impl files |
Move to traits.rs |
Box<dyn Any> |
Use proper trait bounds |
Flat src/ structure |
Use src/modules/[feature]/ |
| Unwrap in library code |
Use Result<T, E> |
1---2name: solid-rust3description: "Use when writing or refactoring Rust code, structuring src/modules/[feature]/ layers, or defining traits.rs interfaces (SOLID, files < 100 lines)."4versions:5 rust: "2024"6user-invocable: true7references: references/solid-principles.md, references/single-responsibility.md, references/open-closed.md, references/liskov-substitution.md, references/interface-segregation.md, references/dependency-inversion.md, references/architecture-patterns.md, references/templates/module.md, references/templates/service.md, references/templates/trait-def.md, references/templates/handler.md, references/templates/error.md, references/templates/test.md8related-skills: solid-detection9metadata:10 source: https://skillmd.com/skills/fusengine/solid-rust11---1213<objective>14SOLID Rust enforces a modular architecture for Rust 2024 edition: every feature lives under `src/modules/[feature]/` (handlers.rs, services.rs, repository.rs, traits.rs, models.rs) with shared code in `src/core/`, traits live only in `traits.rs` or `src/core/traits/`, generics use trait bounds instead of concrete types, `thiserror` handles custom errors, and every public item carries a rustdoc `///` comment.1516Before writing any new code it requires a DRY check against `src/core/services` and `src/core/traits`. See `solid-principles.md` for the overview, the per-principle references for SRP/OCP/LSP/ISP/DIP detail, and the templates for module/service/trait/handler/error/test scaffolding.17</objective>1819# SOLID Rust - Modular Architecture2021## Agent Workflow (MANDATORY)2223Before ANY implementation, spawn 3 agents in parallel, one `Agent` call each with a `name`:24251. **fuse-ai-pilot:explore-codebase** - Analyze existing architecture262. **fuse-ai-pilot:research-expert** - Verify Rust docs via Context7273. **fuse-ai-pilot:sniper** - Post-implementation validation2829---3031## DRY - Reuse Before Creating (MANDATORY)3233**Before writing ANY new code:**341. **Grep the codebase** for similar traits, services, or logic352. Check shared locations: `src/core/services/`, `src/core/traits/`363. If similar code exists -> extend/reuse instead of duplicate374. If code will be used by 2+ features -> create it in `src/core/`3839---4041## Architecture (Modules MANDATORY)4243| Layer | Location | Max Lines |44|-------|----------|-----------|45| Handlers | `src/modules/[feature]/handlers.rs` | 50 |46| Services | `src/modules/[feature]/services.rs` | 100 |47| Repositories | `src/modules/[feature]/repository.rs` | 100 |48| Traits | `src/modules/[feature]/traits.rs` | 30 |49| Models | `src/modules/[feature]/models.rs` | 50 |50| Shared | `src/core/{services,traits,models}/` | - |5152**NEVER use flat `src/` structure - always `src/modules/[feature]/`**5354---5556## Critical Rules (MANDATORY)5758| Rule | Value |59|------|-------|60| File limit | 100 lines (split at 90) |61| Handlers | < 50 lines, delegate to services |62| Traits | `traits.rs` or `src/core/traits/` ONLY |63| Rustdoc | `///` on every public item |64| Error handling | Use `thiserror` for custom errors |65| Generics | Use trait bounds, not concrete types |6667---6869## Reference Guide7071### Concepts7273| Topic | Reference | When to consult |74|-------|-----------|-----------------|75| **SOLID Overview** | [solid-principles.md](references/solid-principles.md) | Quick reference |76| **SRP** | [single-responsibility.md](references/single-responsibility.md) | Fat structs |77| **OCP** | [open-closed.md](references/open-closed.md) | Adding impls |78| **LSP** | [liskov-substitution.md](references/liskov-substitution.md) | Trait contracts |79| **ISP** | [interface-segregation.md](references/interface-segregation.md) | Fat traits |80| **DIP** | [dependency-inversion.md](references/dependency-inversion.md) | Generics/DI |81| **Architecture** | [architecture-patterns.md](references/architecture-patterns.md) | Modular crate |8283### Templates8485| Template | When to use |86|----------|-------------|87| [module.md](references/templates/module.md) | Feature module structure |88| [service.md](references/templates/service.md) | Business logic service |89| [trait-def.md](references/templates/trait-def.md) | Trait definition |90| [handler.md](references/templates/handler.md) | HTTP handler (Axum) |91| [error.md](references/templates/error.md) | Custom errors (thiserror) |92| [test.md](references/templates/test.md) | Unit + integration tests |9394---9596## Forbidden9798| Anti-Pattern | Fix |99|--------------|-----|100| Files > 100 lines | Split at 90 |101| Traits in impl files | Move to `traits.rs` |102| `Box<dyn Any>` | Use proper trait bounds |103| Flat `src/` structure | Use `src/modules/[feature]/` |104| Unwrap in library code | Use `Result<T, E>` |