Files
nextjs-template/AGENTS.md
S.Gromov 9e2167b34d refactor: приведение проекта к стайлгайду
- Разделён 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 с правилами для агентов
2026-03-29 13:23:00 +03:00

3.6 KiB
Raw Permalink Blame History

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

Стайлгайд

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

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.