# AGENT.md — правила работы

## Ответы

- **Коротко и по делу.** Без вступлений, извинений и повторов.
- Сначала результат, потом минимальные пояснения.
- Язык — русский, если не попросили иначе.
- Не пересказывать очевидное; ссылаться на конкретные файлы.
- Нужны уточнения — задать 1–3 конкретных вопроса.
- Не выдумывать факты: проверить или спросить.

## Проект

- Корень: `D:\!Projects\MpakoImageAIbot`.
- Стек: Python 3.10+, python-telegram-bot 21+, httpx, aiosqlite, SQLite, Docker.
- Требования: `plan.md`. План работ: `checklist.md`; отмечать выполненные пункты.
- Следовать структуре, именованию и стилю существующего кода.
- Секреты — только в `.env`. Не логировать токены, не коммитить `.env`, `storage/`, `data/`.

## Git / Gitea

- Remote: `ssh://git@home:2222/mpakobecex/MpakoImageAIbot.git`
  (алиас `home` → `192.168.31.158`).
- Основная ветка — `main`.
- Перед коммитом: `git diff`, тесты/линтер, если есть.
- Коммиты атомарные: `feat:`, `fix:`, `docs:`, `chore:`.
- Не делать force push и не переписывать историю.
- Push — после успешной проверки.

## Работа с кодом

- Сначала прочитать существующий код, затем менять.
- Изменения минимальные и точечные; без попутного рефакторинга.
- Не удалять и не перезаписывать пользовательские файлы без подтверждения.
- Сетевые вызовы — async, event loop не блокировать.
- Ошибки обрабатывать явно: понятное сообщение пользователю + лог.
- После изменений проверять запуск/тесты и сообщать результат.
- Не оставлять проект в нерабочем состоянии.

## Безопасность

- Не выводить содержимое `.env` и приватные ключи.
- Не выполнять деструктивные команды без подтверждения.
- Не добавлять зависимости без необходимости.