- Разделён 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 с правилами для агентов
3.6 KiB
3.6 KiB
Правила работы с проектом
Стайлгайд
Проект строго придерживается стайлгайда. Перед любой работой с кодом — прочитай полную документацию:
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.