# laravel-11-12-app-guidelines

Скилл задаёт правила работы с проектами на Laravel 11 и 12. Он заставляет агента проверять реальное окружение перед внесением правок, а не угадывать дефолты чистой установки.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 976 установок · ★ 70
- Автор: thienanblog
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/thienanblog/awesome-ai-agent-skills/tree/HEAD/skills/laravel-11-12-app-guidelines/SKILL.md
- Обновлён: 2026-10-01
- HTML: https://affpapa.org/nevibecode/skills/laravel-11-12-app-guidelines

## Что делает

Скилл проверяет конфигурацию репозитория по файлам `composer.json`, `package.json` и `bootstrap/app.php`. Ассистент сначала определяет команду запуска — хостовый PHP или Sail, а затем стек фронтенда вроде Inertia или Livewire. Если установлен Laravel Boost, поиск документации идёт через `search-docs` под конкретную мажорную версию фреймворка.

В инструкциях собраны неочевидные тонкости Laravel 11 и 12. При изменении колонок в миграциях через `change()` нужно дублировать все старые модификаторы, иначе фреймворк их удалит. Опасные команды вроде `migrate:fresh` и `db:wipe` запрещено выполнять без прямого подтверждения от пользователя. Для проектов, обновлённых с Laravel 10, скилл сохраняет файлы `Kernel.php` и не пытается переписать их на современный скелет без явной задачи.

Проверку кода агент делает точечно. Он запускает конкретные тесты через `php artisan test <file>` в Pest или PHPUnit. Если в репозитории настроен Pint, форматирование запускается флагом `vendor/bin/pint --dirty`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add thienanblog/awesome-ai-agent-skills --skill laravel-11-12-app-guidelines -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/laravel-11-12-app-guidelines/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/laravel-11-12-app-guidelines/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add thienanblog/awesome-ai-agent-skills --skill laravel-11-12-app-guidelines -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/laravel-11-12-app-guidelines/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add thienanblog/awesome-ai-agent-skills --skill laravel-11-12-app-guidelines -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/laravel-11-12-app-guidelines/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install thienanblog/awesome-ai-agent-skills laravel-11-12-app-guidelines
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/laravel-11-12-app-guidelines/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add thienanblog/awesome-ai-agent-skills --skill laravel-11-12-app-guidelines -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/thienanblog/awesome-ai-agent-skills --path skills/laravel-11-12-app-guidelines
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/laravel-11-12-app-guidelines/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add thienanblog/awesome-ai-agent-skills --skill laravel-11-12-app-guidelines -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/thienanblog/awesome-ai-agent-skills/tree/HEAD/skills/laravel-11-12-app-guidelines/SKILL.md

## Когда брать
- настроить запуск тестов и команд в проекте с Sail или Docker
- сохранить модификаторы столбцов при правке миграций через `change()`
- избежать случайной потери базы данных при вызове деструктивных команд
- согласовать компоненты фронтенда с нужной версией Inertia, Livewire или Tailwind

## Примеры запросов агенту
- Добавь колонку в таблицу users, сохранив старые модификаторы полей
- Создай эндпоинт для API и запусти для него тесты через Pest
- Обнови компонент формы на Inertia с учётом установленной версии

## Похожие
- [laravel-specialist](https://affpapa.org/nevibecode/skills/laravel-specialist.md) — скилл · 23300 установок
- [laravel-tdd](https://affpapa.org/nevibecode/skills/laravel-tdd.md) — скилл · 4900 установок
- [laravel-inertia-react](https://affpapa.org/nevibecode/skills/laravel-inertia-react.md) — скилл · 1900 установок
- [php-pro](https://affpapa.org/nevibecode/skills/httpsgithubcomjeffallan-php-pro.md) — скилл · 15500 установок
- [filament-pro](https://affpapa.org/nevibecode/skills/filament-pro.md) — скилл · 1200 установок
- [pest-testing](https://affpapa.org/nevibecode/skills/pest-testing.md) — скилл · 716 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md