refactor: add _sections.md and flatten reference structure

Add root _sections.md with db and realtime sections. All reference
files use flat structure in references/ directory.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Pedro Rodrigues
2026-02-09 19:21:02 +00:00
parent f50551039b
commit 397502ea42
2 changed files with 19 additions and 12 deletions

View File

@@ -26,17 +26,8 @@ supabase/
| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Getting Started | CRITICAL | `getting-` |
| 2 | Database | CRITICAL | `db-` |
| 3 | Authentication | CRITICAL | `auth-` |
| 4 | Storage | HIGH | `storage-` |
| 5 | Edge Functions | HIGH | `edge-` |
| 6 | Realtime | MEDIUM-HIGH | `realtime-` |
| 7 | SDK | HIGH | `sdk-` |
| 8 | CLI | CRITICAL | `cli-` |
| 9 | MCP | MEDIUM | `mcp-` |
| 10 | Tooling | MEDIUM | `tooling-` |
| 11 | Vectors | MEDIUM | `vectors-` |
| 1 | Database | CRITICAL | `db-` |
| 2 | Realtime | MEDIUM-HIGH | `realtime-` |
Reference files are named `{prefix}-{topic}.md` (e.g., `query-missing-indexes.md`).
@@ -75,4 +66,4 @@ Reference files are named `{prefix}-{topic}.md` (e.g., `query-missing-indexes.md
---
*27 reference files across 11 categories*
*27 reference files across 2 categories*

View File

@@ -0,0 +1,16 @@
# Section Definitions
Reference files are grouped by prefix. Claude loads specific files based on user
queries.
---
## 1. Database (db)
**Impact:** CRITICAL
**Description:** Row Level Security policies, connection pooling, schema design patterns, migrations, performance optimization, and security functions for Supabase Postgres.
## 2. Realtime (realtime)
**Impact:** MEDIUM-HIGH
**Description:** Channel setup, Broadcast messaging, Presence tracking, Postgres Changes listeners, cleanup patterns, error handling, and debugging.