# Инструкции для агентов

Этот файл действует для всего репозитория. Перед изменениями проверьте `README.md`, `CONTRIBUTING.md` и относящиеся к задаче файлы.

## Устройство проекта

- `hypn0/hypn0/` — настройки и маршруты Django; `hypn0/hypn0_site/` — модели, формы, представления, сервисы, команды и тесты.
- `hypn0/templates/` — Django-шаблоны; `public/static/` — публикуемые CSS, JavaScript и изображения.
- `frontend-assembly/` и `scripts/build-*.sh` — исходники и скрипты сборки фронтенд-зависимостей. Порядок сборки описан в `frontend-assembly/README.md`.
- `database/`, `public/media/` и `.env` содержат локальные данные или настройки окружения. Не добавляйте их содержимое в коммиты.

## Разработка и проверка

- Стек: Python 3.14+, Django 6.0+, Poetry; фронтенд использует Tailwind CSS, Alpine.js, HTMX и CodeMirror.
- Зависимости Python устанавливайте из `poetry.lock`. Для локального запуска используйте `poetry run python hypn0/manage.py runserver` после настройки `.env` по `.env.sample` и применения миграций.
- Для изменений в логике Django добавляйте или обновляйте тесты в `hypn0/hypn0_site/tests.py`; запускайте `poetry run python hypn0/manage.py test hypn0_site`.
- При изменении моделей создавайте и проверяйте миграции. Не меняйте существующие миграции, уже применённые в других окружениях.
- После изменения исходников фронтенда запускайте соответствующий `scripts/build-*.sh` и проверяйте полученный файл в `public/static/`.

## Соглашения

- Следуйте существующему стилю кода и правилам `CONTRIBUTING.md`: Python по PEP 8, Black и isort; имена в коде на английском, комментарии и документация к коду на русском; без эмодзи.
- Пользовательский интерфейс и фронтенд (HTML-шаблоны, метатеги, всплывающие подсказки, тексты генератора и сообщения для пользователей) оформляются исключительно на английском языке в научно-фантастической стилистике «Гипножабы / Футурамы» (игра слов, ирония, подчинение разума, бюрократия Нового Нью-Йорка).
- Не включайте в изменения секреты, локальные базы данных, загруженные пользовательские файлы и случайные файлы рабочего окружения. Перед завершением проверяйте `git diff` и `git status`.