Supabase DB Supervisor — Data skill for Claude Code

supabase-db-supervisor

An agent skill that adds a **fresh-eyes supervision pass** to any database work an AI agent builds. A separate agent plays the investigator, proves who can see which data with real queries, and gives an explicit OK before anything ships. The builder never grades its own homework.

**Status: work in progress.** This is v0.1, a starting point published in the open. The checklist, routing logic, and output format will evolve. Issues and PRs welcome.

Why

[Supabase Evals](https://supabase.com/evals) (open sourced July 2026) measured how well coding agents build real Supabase backends across four stages. The headline:

Stage	What it means	Top agents
Build	Create schema, auth, RLS from scratch	~100%
Deploy	Ship it live with secrets and monitoring	~100%
Investigate	Something broke, find out why	67% for most
Resolve	Fix it without breaking more	~100%

Agents are excellent at the part where you feel productive, and weakest at the part where you feel lost. This skill moves the Investigate stage inside the build loop, so the gap gets covered before anything ships instead of at 11pm when it breaks.

How it works

flowchart LR
    A[Agent builds
database work] --> B[Fresh-context
supervisor]
    B --> C[Access proofs
real queries]
    B --> D[Advisors
security + perf]
    B --> E[Migrations
vs reality]
    B --> F[Upstream
freshness]
    C --> V{VERDICT}
    D --> V
    E --> V
    F --> V
    V -->|OK| S[Ship 🏁]
    V -->|NEEDS ATTENTION| R[Fix +