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

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

Различие: спецификации — обязательные правила КАК писать в наших проектах (версионированы под Laravel 11/12/13). best/ — справочник лучших практик и контекст ПОЧЕМУ. При конфликте приоритет у CLAUDE.md и спецификаций.

Навигатор

Файл	О чём
laravel-13.md	L13: PHP-атрибуты, PreventRequestForgery, Queue::route, JSON:API Resources, апгрейд 12→13, property hooks, экосистема, Pest 4, PAO
ai-sdk-vector-search.md	L13: AI SDK — мультиагентные паттерны, streaming, fakes; embeddings и кеш; pgvector: HNSW, гибридный поиск, RAG
laravel-12-structure.md	L11/12/13: streamlined structure, bootstrap/app.php, нет Kernel, casts(), health route, новинки
eloquent-database.md	N+1, strict mode, eager loading, транзакции, chunkById, cursor-пагинация, scopes
architecture-patterns.md	слои, Service/Action, DTO, DI, полиморфизм vs if, YAGNI-слои, error handling
security.md	OWASP в Laravel: SQL/XSS/CSRF, Policy, валидация, signed URLs, секреты, API-коды
performance.md	application-слой: кеш-теги, SWR-кеш, очереди и идемпотентность, production-cache, Octane
infrastructure-performance.md	инфра-слой: уровни кеширования, бюджет памяти, тюнинг PostgreSQL/PHP-FPM/Redis/NGINX/Docker
testing.md	Pest/PHPUnit, factories, fakes, arch-тесты, время в тестах, пирамида, CI
claude-code-workflow.md	Laravel Boost MCP, иерархия MCP, субагенты, TDD через CC, экономия контекста

Версии Laravel

Жизненный цикл версий, совместимость с Filament/Livewire/Tailwind/React и эталон нового проекта — в матрице версий. Коротко на 2026-07: L11 — EOL (только legacy), L12 — мейнстрим студии, L13 — для новых проектов.

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

CLAUDE.md (standard)         — стандарт студии (override-точка)
  ├── specs/                 — обязательные правила по областям, версионированы
  │     laravel_11|12|13/    (выбор версии: specs/README)
  └── best/                  — ЭТОТ раздел: лучшие практики + контекст «почему»

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

Для L13-проектов (и всех новых) — версионные спеки specs/laravel_13/: models, controllers, migrations, services, testing, mcp и остальные — парные L13-файлы здесь: laravel-13.md, ai-sdk-vector-search.md.

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

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