nextjs-template/AGENTS.md

# Правила работы с проектом

## Стайлгайд

Проект строго придерживается стайлгайда. Перед любой работой с кодом — прочитай полную документацию:

https://gromlab.ru/docs/nextjs-style-guide/raw/branch/main/generated/ru/RULES.md

Все решения по архитектуре, именованию, стилям, компонентам и структуре принимаются на основе этого документа. Отклонения от стайлгайда недопустимы без явного согласования.

## Язык общения

- Всегда использовать русский язык: размышления, пояснения, подсказки, инструкции — всё формулировать по-русски.
- Не переключаться на английский без прямого запроса пользователя.

## Коммиты

- НЕ добавлять подпись
- Писать сообщения коммитов на русском языке

### Формат

```
<тип>: <краткое описание>

- Детали в прошедшем времени
- Каждый пункт — отдельное изменение
```

### Типы коммитов

| Тип | Назначение |
|---|---|
| `feat` | Новая функциональность |
| `fix` | Исправление бага |
| `refactor` | Рефакторинг без изменения поведения |
| `style` | Стили, форматирование, отступы |
| `docs` | Документация |
| `chore` | Настройка, зависимости, CI |
| `test` | Тесты |
| `perf` | Оптимизация производительности |

### Правила

- Первая строка — не длиннее 72 символов
- Описание — с маленькой буквы (если не имя собственное)
- Пункты — в прошедшем времени
- Scope (область) опционален: `feat(auth): ...`, `fix(ui): ...`

### Примеры

```
feat: автодополнение и режимы запуска

- Добавлены служебные команды и генерация completion для bash/zsh/fish
- Введён детект режимов запуска (npx/local/direct/global)
- Обновлены help и документация
```

```
fix: некорректная ширина sidebar на мобильных

- Исправлен медиа-запрос для breakpoint --sm
- Убран фиксированный width в пользу max-width
```

```
chore: настройка Biome и VS Code

- Добавлены одинарные кавычки в конфигурацию Biome
- Исключена папка .templates из проверок
- Обновлён quickfix.biome на source.fixAll.biome
```

## Генерация кода

- Модули (компоненты, фичи, виджеты, сущности, layouts, screens, сторы) создаются только из шаблонов `.templates/`.
- Ручное создание файловой структуры модулей запрещено.
- Генерация: `npx @gromlab/create <шаблон> <имя> <путь>`

## Next.js

This is NOT the Next.js you know. This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.