laravel-architecture-review skillA
laravel-architecture-review is agent-read markdown (skill) from majdghithan/agent-skills: Review a Laravel codebase's architecture and design, not just its types. Use when asked to audit a Laravel app, find architectural smells, decide where business logic belongs (controller vs Action vs Service), whether a Repository/DDD/TDD layer is justified, or how to apply SOLID/DRY to a Laravel project. Runs the real tools (Larastan, Rector, Pest) when present, then applies design heuristics the linters cannot see, and produces a prioritized report calibrated to the app's actual scale. Anti-do.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Laravel: architecture review Larastan finds type errors. Pint fixes formatting. Rector modernizes syntax. **None of them tell you the business logic is in the wrong place.** This skill is the layer above the linters: it reads design intent and flags where structure has drifted, then recommends the fix that fits the app's real scale, not a pattern from a blog post. The single rule that makes this skill worth using: **recommend a pattern only when the code earns it.** Most "best practices" advice fails because it applies enterprise patterns to a CRUD app. A Repository layer to "abstract the ORM you will never swap" is ceremony Laravel's own team argues against. Match the recommendation to the evidence. ## Step 0 - Detect before you judge Everything downstream depends on these. Never recommend a pattern without them. ```bash php artisan --version # Laravel version -> which idioms apply composer show | grep -E 'pestphp/pest|phpunit|larastan|rector|pint' # what tooling exists php artisan route:list --json | jq length # rough app size ls app/Models | wc -l # model count …
Read the whole file at its exact version.
How to install
mdr add majdghithan/agent-skills/laravel-architecture-review@git:20260729.8c02853mdr add majdghithan/agent-skills/laravel-architecture-review@sha256:aadbe828bc621d46Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_ts3akkzyiazgwv4t)
1 badge views in 30 days
Versions
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (10089 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
majdghithan/agent-skills · 7 stars · license MIT · pushed 2026-09-20 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_ts3akkzyiazgwv4t GET https://markdownregistry.com/api/v1/resolve?ref=majdghithan/agent-skills/laravel-architecture-review GET https://markdownregistry.com/api/v1/blob/aadbe828bc621d46bd63954f57240061763452e150811f405c6b0c2cb43d77b4
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.