<< All versions

Skill v1.0.0

currentLLM-judged scan90/100
jingjing2222/create-rn-miniapp/supabase-project
──Details
PublishedOctober 21, 2026 at 03:44 PM
Content Hashsha256:17d10271459f0c90...
Git SHAca3f71c7b70b
──Files
Files (1 file, 2.8 KB)
SKILL.md2.8 KBactive
SKILL.md · 80 lines · 2.8 KB

version: "1.0.0" name: supabase-project description: >- Diagnose a Supabase-backed server workspace: separate DB, RLS, Edge Function, env, and project-ref drift; check frontend and backoffice alignment; and distinguish local linkage from remote project state or shared-boundary work. Do not use for remote db apply/deploy or generic route/UI work. compatibility: >- Intended for create-rn-miniapp repositories using the Supabase server provider. Assumes the generated frontend/backoffice/server topology and the repo-owned server/README.md workflow. metadata: create-rn-miniapp.agentsLabel: "Supabase project 작업" create-rn-miniapp.category: "optional" create-rn-miniapp.order: "6"

Supabase Project Skill

Supabase provider를 진단할 때 쓰는 decision skill이다. 목표는 DB/RLS/Edge Function/env/project-ref 문제를 같은 증상으로 뭉개지 않고, local 링크 문제와 remote project 문제를 분리하는 것이다.

Use when

  • Supabase DB, RLS, Edge Function, env, project ref drift를 나눠 볼 때
  • frontend/backoffice가 같은 Supabase project를 보는지 확인할 때
  • local stack 문제와 remote project 문제를 분리할 때

Do not use for

  • remote db:apply, functions:deploy, seed 절차 실행
  • MiniApp route/page/navigation 설계: granite-routing
  • TDS UI 선택: tds-ui

Read in order

  1. server/.create-rn-miniapp/state.json
  2. server/README.md
  3. references/server-common.md
  4. references/provider-overlay.md
  5. workspace ownership이 헷갈리면 docs/engineering/workspace-topology.md

Default checks

  1. DB schema, RLS, Edge Function, env, project ref 중 어느 축인지 먼저 적는다.
  2. server/.env.local의 SUPABASE_PROJECT_REF와 client URL host를 맞춘다.
  3. supabase/migrations/와 supabase/functions/ 중 어느 쪽이 증상과 직접 연결되는지 분리한다.
  4. remoteInitialization이 skipped 또는 not-run이면 remote parity를 가정하지 않는다.

Failure signatures

  • Edge Function 호출이 404거나 다른 프로젝트 응답을 받는다.
  • local DB에는 있는데 remote DB에는 없는 migration을 기대한다.
  • browser에서만 auth/RLS 오류가 난다.
  • frontend와 backoffice가 서로 다른 Supabase host를 쓴다.

Smoke tests

  • node ./scripts/check-env.mjs
  • node ./scripts/check-client-links.mjs
  • server dev
  • server functions:serve
  • server typecheck
  • server db:apply:local
  • server db:reset

Handoff boundary

  • remote db:apply, functions:deploy, seed는 server/README.md Remote Ops
  • 화면 구조는 backoffice-react, MiniApp route는 granite-routing

Report evidence

  • state.json 요약
  • project ref와 client host 비교 결과
  • DB/RLS/Edge Function/env 중 어느 축인지
  • local stack만 깨지는지, remote project만 깨지는지
All versions