Before writing any new code it requires a DRY check against internal/core/services and internal/core/ports. See solid-principles.md for the overview, the per-principle references for SRP/OCP/LSP/ISP/DIP detail, architecture-patterns.md for hexagonal/modular layout, and the templates for module/service/interface/handler/error/test scaffolding.
SOLID Go - 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 Go 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 interfaces, services, or logic
- Check shared locations:
internal/core/services/, internal/core/ports/
- If similar code exists -> extend/reuse instead of duplicate
- If code will be used by 2+ features -> create it in
internal/core/
Architecture (Modules MANDATORY)
| Layer |
Location |
Max Lines |
| Handlers |
internal/modules/[feature]/handlers/ |
50 |
| Services |
internal/modules/[feature]/services/ |
100 |
| Repositories |
internal/modules/[feature]/repositories/ |
100 |
| Ports (interfaces) |
internal/modules/[feature]/ports/ |
30 |
| Models |
internal/modules/[feature]/models/ |
50 |
| Shared |
internal/core/{services,ports,models}/ |
- |
NEVER use flat internal/ structure - always internal/modules/[feature]/
Critical Rules (MANDATORY)
| Rule |
Value |
| File limit |
100 lines (split at 90) |
| Handlers |
< 50 lines, delegate to services |
| Interfaces |
ports/ directory ONLY |
| Godoc |
Every exported function documented |
| Accept interfaces |
Return structs |
| Small interfaces |
1-3 methods max (Go idiom) |
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 providers |
| LSP |
liskov-substitution.md |
Contracts |
| ISP |
interface-segregation.md |
Fat interfaces |
| DIP |
dependency-inversion.md |
Injection |
| Architecture |
architecture-patterns.md |
Hex/modular |
Templates
| Template |
When to use |
| module.md |
Feature module structure |
| service.md |
Business logic service |
| interface.md |
Port definition |
| handler.md |
HTTP handler |
| error.md |
Custom errors |
| test.md |
Table-driven tests |
Forbidden
| Anti-Pattern |
Fix |
| Files > 100 lines |
Split at 90 |
| Interfaces in impl files |
Move to ports/ directory |
| Fat interfaces (4+ methods) |
Split into small interfaces |
Flat internal/ structure |
Use internal/modules/[feature]/ |
init() for dependency wiring |
Use constructor injection |
1---2name: solid-go3description: "Use when writing or refactoring Go code, structuring internal/modules/[feature]/ layers, or defining ports/ interfaces (SOLID, files < 100 lines)."4versions:5 go: "1.23"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/interface.md, references/templates/handler.md, references/templates/error.md, references/templates/test.md8related-skills: solid-detection9metadata:10 source: https://skillmd.com/skills/fusengine/solid-go11---1213<objective>14SOLID Go enforces a modular architecture for Go 1.23+: every feature lives under `internal/modules/[feature]/` (handlers, services, repositories, ports, models) with shared code in `internal/core/`, interfaces (ports) live only in `ports/` directories and stay small (1-3 methods, the Go idiom), functions accept interfaces but return structs, and every exported function carries a godoc comment.1516Before writing any new code it requires a DRY check against `internal/core/services` and `internal/core/ports`. See `solid-principles.md` for the overview, the per-principle references for SRP/OCP/LSP/ISP/DIP detail, `architecture-patterns.md` for hexagonal/modular layout, and the templates for module/service/interface/handler/error/test scaffolding.17</objective>1819# SOLID Go - 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 Go 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 interfaces, services, or logic352. Check shared locations: `internal/core/services/`, `internal/core/ports/`363. If similar code exists -> extend/reuse instead of duplicate374. If code will be used by 2+ features -> create it in `internal/core/`3839---4041## Architecture (Modules MANDATORY)4243| Layer | Location | Max Lines |44|-------|----------|-----------|45| Handlers | `internal/modules/[feature]/handlers/` | 50 |46| Services | `internal/modules/[feature]/services/` | 100 |47| Repositories | `internal/modules/[feature]/repositories/` | 100 |48| Ports (interfaces) | `internal/modules/[feature]/ports/` | 30 |49| Models | `internal/modules/[feature]/models/` | 50 |50| Shared | `internal/core/{services,ports,models}/` | - |5152**NEVER use flat `internal/` structure - always `internal/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| Interfaces | `ports/` directory ONLY |63| Godoc | Every exported function documented |64| Accept interfaces | Return structs |65| Small interfaces | 1-3 methods max (Go idiom) |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 providers |78| **LSP** | [liskov-substitution.md](references/liskov-substitution.md) | Contracts |79| **ISP** | [interface-segregation.md](references/interface-segregation.md) | Fat interfaces |80| **DIP** | [dependency-inversion.md](references/dependency-inversion.md) | Injection |81| **Architecture** | [architecture-patterns.md](references/architecture-patterns.md) | Hex/modular |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| [interface.md](references/templates/interface.md) | Port definition |90| [handler.md](references/templates/handler.md) | HTTP handler |91| [error.md](references/templates/error.md) | Custom errors |92| [test.md](references/templates/test.md) | Table-driven tests |9394---9596## Forbidden9798| Anti-Pattern | Fix |99|--------------|-----|100| Files > 100 lines | Split at 90 |101| Interfaces in impl files | Move to `ports/` directory |102| Fat interfaces (4+ methods) | Split into small interfaces |103| Flat `internal/` structure | Use `internal/modules/[feature]/` |104| `init()` for dependency wiring | Use constructor injection |