Init

AGENTS.md

@@ -0,0 +1,35 @@
+## О проекте
+
+О проекте - в README.md.
+
+## Правила кодирования
+
+### uv
+
+В проекте используется uv. С помощью uv add добавляем зависимости.
+С помощью uv run запускаем.
+
+### Type hints
+Используй современный синтаксис type hints:
+- `list[]`, `dict[]`, `tuple[]`, `set[]` вместо List, Dict, etc.
+- `| None` вместо Optional
+- Всегда указывай типы для параметров и возвращаемых значений
+
+### Комментари ие комментарии в коде
+- Только короткие докстринги к функциям на одну-две строчки
+- Код должен быть самодокументируемым
+
+### Логирование
+- Используй базовое логирование через модуль `src/logger.py`
+- **INFO** уровень - основные логи для пользователя (что происходит)
+- **DEBUG** уровень - детальная информация для отладки
+- Не спамь логами, только важная информация
+- Уровень логирования настраивается через `LOG_LEVEL` в `.env`
+
+## Конфигурация
+Все секреты и настройки хранятся в `.env`. Смотри `.env.example` для примера.
+
+### Переменные окружения
+- Не используй значения по умолчанию для переменных окружения
+- Если переменная не задана — выбрасывай ошибку при старте
+- Это помогает сразу обнаружить проблемы с конфигурацией