Лучшие практики Laravel + Claude Code

Подборка общепринятых лучших практик разработки Laravel и эффективной работы через Claude Code. Дополняет, не заменяет внутренние правила студии в ../*.md.

Различие: specs/*.md (уровнем выше) — обязательные правила КАК писать в наших проектах. specs/best/*.md — справочник лучших практик и контекст ПОЧЕМУ. При конфликте приоритет у laravel/CLAUDE.md и specs/*.md.

Навигатор

Файл	О чём
laravel-12-structure.md	L11/12/13: streamlined structure, bootstrap/app.php, нет Kernel, casts(), health route, новинки
eloquent-database.md	N+1, eager loading, транзакции, chunkById, scopes, mass assignment
architecture-patterns.md	слои, Service/Action, DTO, DI, полиморфизм vs if, error handling
security.md	OWASP в Laravel: SQL/XSS/CSRF, Policy, валидация, секреты, API-коды
performance.md	application-слой: кеш-теги, очереди, production-cache, профилирование, Octane
infrastructure-performance.md	инфра-слой: уровни кеширования, бюджет памяти, тюнинг PostgreSQL/PHP-FPM/Redis/NGINX/Docker
testing.md	Pest/PHPUnit, factories, fakes, пирамида тестов, CI
claude-code-workflow.md	Laravel Boost MCP, иерархия MCP, субагенты, TDD через CC, экономия контекста

Версии Laravel (актуально 2026-05)

Версия	PHP	Релиз	Security до	Статус
11	8.2–8.4	мар 2024	мар 2026	structural revolution; security заканчивается
12	8.2–8.5	фев 2025	фев 2027	стабильный, рекомендуем для prod
13	8.3–8.5	Q1 2026	Q1 2028	новейший, для новых проектов

Новый проект в 2026 → L12 (стабильный) или L13. Структурно L12/13 = L11 (streamlined).

Связь с внутренними правилами

laravel/CLAUDE.md           — стандарт студии (override-точка)
  ├── specs/*.md            — обязательные правила по областям (models, controllers, …)
  └── specs/best/*.md       — ЭТА папка: лучшие практики + контекст

Эталонные внутренние specs, на которые опираются файлы здесь: ../models.md, ../controllers.md, ../migrations.md, ../services.md, ../code-quality.md, ../blade.md, ../filament.md, ../testing.md, ../mcp.md, ../anti-hardcode.md, ../../LIMITS-OPTIMIZATION.md.

Авторитетные источники

• Официальная дока: laravel.com/docs (версионная; через laravel-boost__search-docs)
• Spatie guidelines, Beyond Code, Laravel News
• Larastan (PHPStan), Pint (style), Pest (тесты), Telescope/Pulse (профайл)