AGENTS.md

> Скопируйте в корень проекта и отредактируйте. Не больше 40 строк. > Только проверяемые правила — никаких «пишите хороший код».

Проект: <название>

Стек

• Язык: <версия>
• Фреймворк: <название + версия>
• Тесты: <pytest / vitest / go test>
• Линтер: <ruff / eslint>
• Типы: <mypy / tsc>

Команды

• всё сразу: ./scripts/check.sh
• тесты: <команда>
• линтер: <команда>
• запуск: <команда>

Конвенции

• <например: типизация обязательна, mypy в strict>
• <например: ошибки через AppError, не raise ValueError>
• <например: тесты рядом с кодом, test_*.py>
• <например: никаких новых зависимостей без обсуждения>

Запрещено

• менять .env и секреты
• коммитить в main
• править migrations/ вручную
• отключать тесты (skip, xfail) без явной причины

Документация

• архитектурные решения: docs/decisions.md
• спеки: docs/specs/

Процесс

• сначала план, потом код
• один шаг — один коммит
• после шага — ./scripts/check.sh