mcpField
L
laravel-architecture

laravel-architecture

github.com/leeoveryDevelopment1562 installsUpdated 3w ago
Repository

About laravel-architecture

A reference skill for choosing and structuring architecture patterns in Laravel applications. It covers domain logic, data transfer, state transitions, integrations, project layout, and practical decision guidance for Laravel developers.

Key features

  1. 01Apply Actions to domain logic
  2. 02Use DTOs for data transfer
  3. 03Choose patterns with decision flows
  4. 04Organize files and namespaces
  5. 05Follow implementation and deployment checklists

Use cases

  1. 01Select a pattern for complex state changes
  2. 02Structure an external API integration
  3. 03Separate HTTP controllers from domain logic
  4. 04Plan feature development and deployment

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/leeovery/agentic-skills --skill laravel-architecture

After installing, type/laravel-architecturein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
checklist.md
decisions.md
examples.md
patterns.md
philosophy.md
structure.md

Details

From the project README

Laravel Architecture

High-level architectural guidance for Laravel applications.

Core Concepts

philosophy.md - Foundational principles:

  • Declarative code above all else
  • Strict separation of concerns
  • Type safety first
  • All core architectural principles

patterns.md - Pattern overview:

  • Actions for domain logic
  • DTOs for data transfer
  • State machines for complex state
  • Services for external integration
  • Workflows for multi-step processes
  • Value objects for domain values

decisions.md - Pattern selection:

  • When to use each pattern
  • Decision flowcharts
  • Architectural trade-offs
  • Common scenarios

structure.md - Directory structure:

  • Complete project organization
  • File placement rules
  • Namespace conventions
  • Web vs API distinction

examples.md - Reference implementations:

  • Complete working examples
  • End-to-end workflows
  • Real-world patterns

checklist.md - Implementation checklist:

  • Setup tasks
  • Feature development workflow
  • Production deployment steps

Core Principles

  1. Actions contain domain logic - Business logic lives in invokable action classes
  2. Never pass primitives - Always use DTOs for data transfer
  3. Thin HTTP layer - Controllers only handle HTTP concerns
  4. Custom query builders - Type-safe queries over scopes
  5. Strict typing - declare(strict_types=1) in every file

Quick Decision Tree

Need to...

  • Handle domain logic? → Action
  • Transfer data? → DTO
  • Validate user input? → Form Request
  • Simple state field? → Enum
  • Complex state transitions? → State Machine
  • External API? → Service with Saloon
  • Background processing? → Job (delegates to Action)

Read decision flowcharts in decisions.md for detailed guidance.

Comments

Markdown supported