Laravel Domain Architecture

Guide for creating and refactoring Laravel applications using a pragmatic domain-oriented architecture. Based on patterns from "Laravel Beyond CRUD" (Brent Roose / Spatie), simplified to work with pure PHP and native Laravel features — no mandatory external packages.

Core philosophy: group code by business meaning, not by technical property. Don't fight the framework.

Agent Instructions

• When creating or modifying Domain layer components (Actions, Data Objects, Models, Enums, QueryBuilders, Collections, Events) -> consult references/domain-building-blocks.md
• When creating or modifying Application layer components (Controllers, Requests, Resources, Queries, Jobs, API Versioning) -> consult references/application-layer.md
• Do not load both references at once — use only the one relevant to the current task
• Always follow the naming conventions and anti-patterns listed below