Skill

solid-python

SOLID principles for Python 3.12+. Files < 100 lines, interfaces separated, modular architecture. Modules MANDATORY.

Install

Run in your terminal

npx claudepluginhub fusengine/agents --plugin fuse-solid

Tool Access

This skill uses the workspace's default tool permissions.

Supporting Assets

View in Repository

references/patterns.md

references/principles.md

Skill Content

Similar Skills

agent-payment-x402

Enables AI agents to execute x402 payments with per-task budgets, spending controls, and non-custodial wallets via MCP tools. Use when agents pay for APIs, services, or other agents.

ecc

140.7k

agent-eval

Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.

ecc

140.7k

agent-harness-construction

Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.

ecc

140.7k

Stats

Parent Repo Stars4

Parent Repo Forks0

Last CommitMar 26, 2026

Actions

View Source View Plugin View on GitHub View README

Architecture (Modules MANDATORY)

Layer

Location

Max Lines

Routes

modules/[feature]/routes/

Services

modules/[feature]/services/

100

Repositories

modules/[feature]/repositories/

100

Interfaces

modules/[feature]/interfaces/

Models

modules/[feature]/models/

Shared

core/{services,interfaces,models}/

NEVER use flat src/ structure - always modules/[feature]/

Rule

Value

File limit

100 lines (split at 90)

Routes

< 50 lines, delegate to services

Interfaces

interfaces/ directory ONLY

Docstrings

Every public function documented

Type hints

MANDATORY on all signatures

Protocols

Use typing.Protocol for interfaces

Small interfaces

1-3 methods max

Topic

Reference

When to consult

SOLID Principles

principles.md

Quick reference for all 5 principles

Patterns & Structure

patterns.md

Directory layout, testing, typing

Forbidden

Anti-Pattern

Fix

Files > 100 lines

Split at 90

Interfaces in impl files

Move to interfaces/ directory

Fat interfaces (4+ methods)

Split into small Protocols

Flat src/ structure

Use modules/[feature]/

Concrete dependencies

Use Protocol + dependency injection

Missing type hints

Add type annotations to all signatures

SOLID Python - Modular Architecture

Agent Workflow (MANDATORY)

Before ANY implementation, use TeamCreate to spawn 3 agents:

fuse-ai-pilot:explore-codebase - Analyze existing architecture
fuse-ai-pilot:research-expert - Verify Python 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: core/services/, core/interfaces/
If similar code exists -> extend/reuse instead of duplicate
If code will be used by 2+ features -> create it in core/

Architecture (Modules MANDATORY)

Layer	Location	Max Lines
Routes	`modules/[feature]/routes/`	50
Services	`modules/[feature]/services/`	100
Repositories	`modules/[feature]/repositories/`	100
Interfaces	`modules/[feature]/interfaces/`	30
Models	`modules/[feature]/models/`	50
Shared	`core/{services,interfaces,models}/`	-

NEVER use flat src/ structure - always modules/[feature]/

Critical Rules (MANDATORY)

Rule	Value
File limit	100 lines (split at 90)
Routes	< 50 lines, delegate to services
Interfaces	`interfaces/` directory ONLY
Docstrings	Every public function documented
Type hints	MANDATORY on all signatures
Protocols	Use `typing.Protocol` for interfaces
Small interfaces	1-3 methods max

Reference Guide

Topic	Reference	When to consult
SOLID Principles	principles.md	Quick reference for all 5 principles
Patterns & Structure	patterns.md	Directory layout, testing, typing

Forbidden

Anti-Pattern	Fix
Files > 100 lines	Split at 90
Interfaces in impl files	Move to `interfaces/` directory
Fat interfaces (4+ methods)	Split into small Protocols
Flat `src/` structure	Use `modules/[feature]/`
Concrete dependencies	Use Protocol + dependency injection
Missing type hints	Add type annotations to all signatures