PyKorone

Use when generating, editing, or reviewing Python code in this project, especially under src/korone. Follow comprehensive type hints with modern syntax, snake_case naming, explicit imports, async-first architecture, repository-based database access, project handler bases, structured logging, and strict Ruff/Pyright expectations.

Use when editing code that uses aiogram in src/korone. Enforce current aiogram 3.x APIs and PyKorone patterns for Dispatcher setup, routers, class-based handlers, middlewares, callback data, filters, and webhook or polling bootstrapping.

Use when editing development tooling configuration or workflows in this repository, including uv, Ruff, pre-commit, Pyright, Alembic, Babel locale tasks, Docker build/runtime setup, Makefile targets, pyproject.toml, ruff.toml, .python-version, Dockerfile, docker-compose.yml, alembic files, and runtime bootstrap.

Use when creating or editing loadable top-level module packages under src/korone/modules, especially src/korone/modules/*/__init__.py files listed by korone.modules.MODULES. Follow the current ModuleManifest, ModulePackage, router, handlers tuple, scripts, stats, and export contract expected by the PyKorone runtime module loader.

Use when user-facing strings are added, changed, or removed in src/korone, or when gettext locale catalogs under locales are edited. Enforce PyKorone manual translation review, Babel Makefile workflow, placeholder preservation, fuzzy entry resolution, and catalog compilation.

Use when creating or editing the medias module in src/korone/modules/medias. Follow PyKorone structure and patterns for handlers, filters, provider adapters, platform packages, URL parsing, caching, media downloads, soft failures, and structured error reporting.