pipu-music/AGENTS.md

Работа с проектом

• Начинай с ближайшего локального AGENTS.md и файлов конкретной возможности. Карта документов: docs/README.md; реализация архитектуры: docs/architecture.md.
• Web/desktop UI: apps/web/src; Android: apps/mobile/src; общие правила клиентов: packages/core/src; Go API: services/api/internal; рекомендации: services/recommender/pipu_rec.
• Контракт HTTP — api/openapi.yaml. Читай нужную операцию и связанные схемы. Generated-код (**/gen/**, **/generated/**) и lock-файлы исследуй точечно; не редактируй вручную.
• После изменения OpenAPI: pnpm --filter @pipu/api-client generate, затем из services/api: go generate ./.... Проверяй и коммить результат генерации.
• Новые правила размещай у владельца сценария, IO — в адаптере. Сохраняй явные границы транзакций и платформенные особенности. Узкий интерфейс вводи для конкретного потребителя.
• Локально достаточно запускать проверки затронутой области и непосредственно связанных сценариев. Полный набор тестов и проверок повторно выполняется в CI/CD; не запускай все проверки проекта перед каждой сдачей без необходимости. Расширяй локальную проверку при изменении общих контрактов, межмодульных зависимостей или при обнаружении ошибок. Команды запускаются из корня, если не сказано иначе.
• Справочник полных проверок (выбирай локально только относящиеся к изменению): pnpm typecheck, pnpm test, pnpm i18n:check, pnpm test:scripts. Go: из services/api — go vet ./..., go test ./.... Python: из services/recommender — uv run ruff check ., uv run mypy pipu_rec, uv run pytest.
• Не меняй пользовательские артефакты, локальные бинарники и посторонние незакоммиченные файлы.