code-quality

Code Quality Review

Review code quality in the directory provided by the user.

Instructions

1. Identify files to review:

   • Find all .py files in the directory
   • Exclude migrations, __pycache__, and generated files

2. Run automated checks:

   uv run ruff check <directory>
   uv run ruff format --check <directory>
   uv run pyright <directory>
   uv run pytest <directory> -v
   

1. Manual review checklist:

   • No Any types without justification
   • Proper error handling (no silent exceptions)
   • N+1 queries avoided (select_related/prefetch_related)
   • Forms have proper validation
   • Views return correct HTTP status codes
   • HTMX partials handle HX-Request header
   • Celery tasks are idempotent
   • Tests use factories, not raw object creation

2. Report findings organized by severity:

   • Critical (must fix)
   • Warning (should fix)
   • Suggestion (could improve)