S.Gromov
9e2167b34d
- Разделён globals.css на styles/variables.css, media.css, reset.css - Добавлен styles/index.css как единая точка входа глобальных стилей - Вынесен MantineProvider в app/providers/ - Переименован .ui.tsx в .tsx в шаблоне component - Приведены CSS-токены радиусов к числовой шкале (--radius-1, --radius-2...) - Добавлен слой src/layouts/ - Настроен Biome: одинарные кавычки, исключены .templates, разрешён @custom-media - Обновлён .vscode/settings.json (quickfix.biome → source.fixAll.biome) - Обновлён AGENTS.md с правилами для агентов
84 lines
3.6 KiB
Markdown
84 lines
3.6 KiB
Markdown
# Правила работы с проектом
|
||
|
||
## Стайлгайд
|
||
|
||
Проект строго придерживается стайлгайда. Перед любой работой с кодом — прочитай полную документацию:
|
||
|
||
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.
|