Use when editing ANY grading code or data: services/edge-functions/src/lib/ai-grading.ts, grading-pipeline.ts, grading-eval.ts, grading-shadow.ts, accuracy-tracking.ts, human-review*, few-shot-exemplars.ts, peer-norm.ts, fabric-criteria.ts, garment-baselines.ts, defect-weighting.ts, routes/admin-grading.ts, the admin reviews UI (src/pages/admin/reviews.tsx, grading.tsx), grade_reports/human_reviews migrations, or grading prompts. Encodes the grading domain contract: factor weights, rounding lockstep, prompt-version lifecycle, golden set, exemplar privacy, review thresholds.
Use when building or DEBUGGING any queued/background work on the edge: generation batches (flipdesk-autolister processBatch), bulk publish, feed sync, reclaim crons, jobs-*.ts routes, batch/job tables (listing_generation_jobs, publish batches), heartbeats, stale sweeps, or any report that a batch 'did nothing' / stalled. Encodes the batch/claim/heartbeat/reclaim contract and the DB-rows-first debugging procedure.
Use when creating or editing ANY file under supabase/migrations/, bumping EXPECTED_SCHEMA_VERSION (services/edge-functions/src/lib/schema-version.ts), applying migrations to prod, or committing work that contains a migration. Encodes the US-1108 migration triple (idempotent / version bump same commit / self-record footer), the held-migration push rule, and the prod-apply runbook.
Use when writing or editing ANY edge route or lib that queries a multi-tenant table with the service-role client (services/edge-functions/**): submissions, grade_reports, inventory_items, listings, sales, item_photos, marketplace_connections, api_keys, human_reviews, and friends. Encodes US-268: the explicit-scoping rule, ownership-via-parent, the tenant-isolation_test.ts case rule, and rls-guard registration for operator tables.