solid-php
Use when applying SOLID principles to Laravel 13 / PHP 8.3+ code — file size limits, interface placement, or PHPDoc enforcement.
How do I install this agent skill?
npx skills add https://github.com/fusengine/claude-plugins --skill solid-phpIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a set of architectural guidelines and code templates designed to enforce SOLID principles and DRY in PHP 8.3+ and Laravel 13 projects. It follows a specific modular structure (FuseCore) and utilizes parallel agent orchestration for code analysis and validation. No security violations or malicious patterns were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
SOLID PHP - Laravel 13 + PHP 8.3
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 Laravel/PHP docs via Context7
- mcp__context7__query-docs - Check SOLID patterns
After implementation, run fuse-ai-pilot:sniper for validation.
DRY - Reuse Before Creating (MANDATORY)
Before writing ANY new code:
- Grep the codebase for similar class names, methods, or logic
- Check shared locations:
FuseCore/Core/App/Services/,FuseCore/Core/App/Traits/,FuseCore/[Module]/App/Contracts/ - If similar code exists → extend/reuse instead of duplicate
- If code will be used by 2+ features → create it in shared Services or Traits
- Extract repeated logic (3+ occurrences) into shared helpers or Traits
- Verify no duplication introduced after writing
Auto-Detection (Modular MANDATORY)
| Files Detected | Architecture | Interfaces Location |
|---|---|---|
FuseCore/ directory | FuseCore Modular | FuseCore/[Module]/App/Contracts/ |
module.json in modules | FuseCore Modular | FuseCore/[Module]/App/Contracts/ |
Verification: php artisan --version → Laravel 13.x
Structure: Always FuseCore modular. Shared in FuseCore/Core/App/.
Decision Tree: Where to Put Code? (FuseCore Modular)
New code needed?
├── HTTP validation → FuseCore/[Module]/App/Http/Requests/
├── Single action → FuseCore/[Module]/App/Actions/
├── Business logic → FuseCore/[Module]/App/Services/
├── Data access → FuseCore/[Module]/App/Repositories/
├── Data transfer → FuseCore/[Module]/App/DTOs/
├── Interface → FuseCore/[Module]/App/Contracts/
├── Event → FuseCore/[Module]/App/Events/
└── Authorization → FuseCore/[Module]/App/Policies/
Decision Tree: Which Pattern?
| Need | Pattern | Location |
|---|---|---|
| HTTP handling | Controller | Controllers/ |
| Validation | FormRequest | Requests/ |
| Single operation | Action | Actions/ |
| Complex logic | Service | Services/ |
| Data access | Repository | Repositories/ |
| Data structure | DTO | DTOs/ |
| Abstraction | Interface | Contracts/ |
Critical Rules (MANDATORY)
1. Files within FUSE_SOLID_MAX_LINES
- Split well before the hook ceiling - never work around it
- Controllers: HTTP concerns only
- Models: relations + casts only
- Services: business logic only
2. Interfaces Separated (FuseCore Modular MANDATORY)
FuseCore/[Module]/App/Contracts/ # Module interfaces ONLY
├── UserRepositoryInterface.php
└── PaymentGatewayInterface.php
FuseCore/Core/App/Contracts/ # Shared interfaces
3. PHPDoc Mandatory
/**
* Create a new user from DTO.
*
* @param CreateUserDTO $dto User data transfer object
* @return User Created user model
* @throws ValidationException If email already exists
*/
public function create(CreateUserDTO $dto): User
Reference Guide
Concepts
| Topic | Reference | When to consult |
|---|---|---|
| SOLID Overview | solid-principles.md | Quick reference all principles |
| SRP | single-responsibility.md | File too long, fat controller/model |
| OCP | open-closed.md | Adding payment methods, channels |
| LSP | liskov-substitution.md | Interface contracts, swapping providers |
| ISP | interface-segregation.md | Fat interfaces, unused methods |
| DIP | dependency-inversion.md | Tight coupling, testing, mocking |
| Anti-Patterns | anti-patterns.md | Code smells detection |
| Decisions | decision-guide.md | Pattern selection |
| PHP 8.5 | php85-features.md | Modern PHP features |
| Structure | laravel12-structure.md | Standard Laravel |
| FuseCore | fusecore-structure.md | Modular architecture |
Templates
| Template | When to use |
|---|---|
| code-templates.md | Service, DTO, Repository, Interface |
| controller-templates.md | Controller, Action, FormRequest, Policy |
| refactoring-guide.md | Step-by-step migration from legacy code |
Forbidden
| Anti-Pattern | Detection | Fix |
|---|---|---|
Files above FUSE_SOLID_MAX_LINES | Line count | Split into smaller files |
| Controllers with business logic | Code review | Extract to Service |
| Interfaces in impl files | Location | Move to FuseCore/[Module]/App/Contracts/ |
| Business logic in Models | Code in model | Extract to Service |
| Concrete dependencies | new Class() | Inject via ModuleServiceProvider |
| Missing PHPDoc | No doc block | Add documentation |
| Missing strict_types | No declare | Add to all files |
| Fat classes | > 5 public methods | Split responsibilities |
| Duplicated logic | Same code in 2+ files | Extract to Service/Trait |
| No Grep before coding | Creating without search | Grep codebase first |
Best Practices
| DO | DON'T |
|---|---|
| Use constructor property promotion | Use property assignment |
| Depend on interfaces | Depend on concrete classes |
Use final readonly class | Use mutable classes |
Use declare(strict_types=1) | Skip type declarations |
Split well before FUSE_SOLID_MAX_LINES | Wait until the hook blocks |
| Use DTOs for data transfer | Use arrays |
Laravel 13 Notes
PHP 8.3 minimum
Laravel 13 requires PHP 8.3 (was 8.2 on L12). SOLID-friendly features:
readonlyclasses:final readonly class UserDto(full immutability)- Typed class constants:
const int MAX_RETRIES = 3; #[\Override]attribute: explicitly declares an override of a parent method (catches typos)- Native
json_validate()(faster thanjson_decode+ try/catch) - Dynamic class constant fetch:
$class::{$name}
use Override;
final readonly class PaymentService implements PaymentContract
{
public const int DEFAULT_TIMEOUT = 30;
public function __construct(
private StripeClient $stripe,
private LoggerInterface $logger,
) {}
#[Override]
public function process(PaymentDto $payment): PaymentResult
{
// ...
}
}
Stricter SOLID rules for L13
- Prefer
final readonly classfor all DTOs/Value Objects - Use
#[\Override]on every inherited method (caught in CI) - Type constants (
const string ROLE = 'admin';)
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/fusengine/claude-plugins/solid-php">View solid-php on skillZs</a>