Before writing any new code it requires a DRY check against app/modules/core/services and app/modules/core/contracts. See solid-principles.md for the overview, the per-principle references for SRP/OCP/LSP/ISP/DIP detail, and the templates for module/service/contract/model/error/test scaffolding.
SOLID Ruby - 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 Ruby/Rails 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 modules, services, or logic
- Check shared locations:
app/modules/core/services/, app/modules/core/contracts/
- If similar code exists -> extend/reuse instead of duplicate
- If code will be used by 2+ features -> create it in
app/modules/core/
Architecture (Modules MANDATORY)
| Layer |
Location |
Max Lines |
| Controllers |
app/modules/[feature]/controllers/ |
50 |
| Services |
app/modules/[feature]/services/ |
100 |
| Repositories |
app/modules/[feature]/repositories/ |
100 |
| Contracts |
app/modules/[feature]/contracts/ |
30 |
| Models |
app/modules/[feature]/models/ |
50 |
| Shared |
app/modules/core/{services,contracts,concerns}/ |
- |
NEVER use flat app/ structure - always app/modules/[feature]/
Critical Rules (MANDATORY)
| Rule |
Value |
| File limit |
100 lines (split at 90) |
| Controllers |
< 50 lines, delegate to services |
| Contracts |
contracts/ directory ONLY (duck typing modules) |
| YARD doc |
Every public method documented |
| Frozen string |
# frozen_string_literal: true in every file |
| Concerns |
Use for shared behavior (like interfaces) |
Reference Guide
Concepts
| Topic |
Reference |
When to consult |
| SOLID Overview |
solid-principles.md |
Quick reference |
| SRP |
single-responsibility.md |
Fat classes |
| OCP |
open-closed.md |
Adding strategies |
| LSP |
liskov-substitution.md |
Contracts |
| ISP |
interface-segregation.md |
Fat modules |
| DIP |
dependency-inversion.md |
Injection |
| Architecture |
architecture-patterns.md |
Modular Rails |
Templates
| Template |
When to use |
| module.md |
Feature module structure |
| service.md |
Business logic service |
| contract.md |
Duck typing contracts |
| model.md |
Active Record model |
| error.md |
Custom exceptions |
| test.md |
RSpec tests |
Forbidden
| Anti-Pattern |
Fix |
| Files > 100 lines |
Split at 90 |
| Business logic in models |
Extract to service |
| Fat controllers |
Delegate to services |
Flat app/ structure |
Use app/modules/[feature]/ |
| God classes |
Split by responsibility |
1---2name: solid-ruby3description: "Use when writing or refactoring Ruby/Rails code, structuring app/modules/[feature]/ layers, or defining contracts/ modules (SOLID, files < 100 lines)."4versions:5 ruby: "3.3"6 rails: "8"7user-invocable: true8references: 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/contract.md, references/templates/model.md, references/templates/error.md, references/templates/test.md9related-skills: solid-detection10metadata:11 source: https://skillmd.com/skills/fusengine/solid-ruby12---1314<objective>15SOLID Ruby enforces a modular architecture for Ruby 3.3+/Rails 8: every feature lives under `app/modules/[feature]/` (controllers, services, repositories, contracts, models) with shared code in `app/modules/core/`, contracts (duck-typing modules) live only in `contracts/` directories, `# frozen_string_literal: true` is required in every file, and every public method carries YARD documentation.1617Before writing any new code it requires a DRY check against `app/modules/core/services` and `app/modules/core/contracts`. See `solid-principles.md` for the overview, the per-principle references for SRP/OCP/LSP/ISP/DIP detail, and the templates for module/service/contract/model/error/test scaffolding.18</objective>1920# SOLID Ruby - Modular Architecture2122## Agent Workflow (MANDATORY)2324Before ANY implementation, spawn 3 agents in parallel, one `Agent` call each with a `name`:25261. **fuse-ai-pilot:explore-codebase** - Analyze existing architecture272. **fuse-ai-pilot:research-expert** - Verify Ruby/Rails docs via Context7283. **fuse-ai-pilot:sniper** - Post-implementation validation2930---3132## DRY - Reuse Before Creating (MANDATORY)3334**Before writing ANY new code:**351. **Grep the codebase** for similar modules, services, or logic362. Check shared locations: `app/modules/core/services/`, `app/modules/core/contracts/`373. If similar code exists -> extend/reuse instead of duplicate384. If code will be used by 2+ features -> create it in `app/modules/core/`3940---4142## Architecture (Modules MANDATORY)4344| Layer | Location | Max Lines |45|-------|----------|-----------|46| Controllers | `app/modules/[feature]/controllers/` | 50 |47| Services | `app/modules/[feature]/services/` | 100 |48| Repositories | `app/modules/[feature]/repositories/` | 100 |49| Contracts | `app/modules/[feature]/contracts/` | 30 |50| Models | `app/modules/[feature]/models/` | 50 |51| Shared | `app/modules/core/{services,contracts,concerns}/` | - |5253**NEVER use flat `app/` structure - always `app/modules/[feature]/`**5455---5657## Critical Rules (MANDATORY)5859| Rule | Value |60|------|-------|61| File limit | 100 lines (split at 90) |62| Controllers | < 50 lines, delegate to services |63| Contracts | `contracts/` directory ONLY (duck typing modules) |64| YARD doc | Every public method documented |65| Frozen string | `# frozen_string_literal: true` in every file |66| Concerns | Use for shared behavior (like interfaces) |6768---6970## Reference Guide7172### Concepts7374| Topic | Reference | When to consult |75|-------|-----------|-----------------|76| **SOLID Overview** | [solid-principles.md](references/solid-principles.md) | Quick reference |77| **SRP** | [single-responsibility.md](references/single-responsibility.md) | Fat classes |78| **OCP** | [open-closed.md](references/open-closed.md) | Adding strategies |79| **LSP** | [liskov-substitution.md](references/liskov-substitution.md) | Contracts |80| **ISP** | [interface-segregation.md](references/interface-segregation.md) | Fat modules |81| **DIP** | [dependency-inversion.md](references/dependency-inversion.md) | Injection |82| **Architecture** | [architecture-patterns.md](references/architecture-patterns.md) | Modular Rails |8384### Templates8586| Template | When to use |87|----------|-------------|88| [module.md](references/templates/module.md) | Feature module structure |89| [service.md](references/templates/service.md) | Business logic service |90| [contract.md](references/templates/contract.md) | Duck typing contracts |91| [model.md](references/templates/model.md) | Active Record model |92| [error.md](references/templates/error.md) | Custom exceptions |93| [test.md](references/templates/test.md) | RSpec tests |9495---9697## Forbidden9899| Anti-Pattern | Fix |100|--------------|-----|101| Files > 100 lines | Split at 90 |102| Business logic in models | Extract to service |103| Fat controllers | Delegate to services |104| Flat `app/` structure | Use `app/modules/[feature]/` |105| God classes | Split by responsibility |