refactor: flatten vectors references to root references directory

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

skills/supabase/AGENTS.md

@@ -4,7 +4,7 @@
 
 ## Overview
 
-Guides and best practices for working with Supabase. Covers getting started, Auth, Database, Storage, Edge Functions, Realtime, supabase-js SDK, CLI, and MCP integration. Use for any Supabase-related questions.
+Guides and best practices for working with Supabase. Covers getting started, Auth, Database, Vectors/AI, Storage, Edge Functions, Realtime, supabase-js SDK, CLI, and MCP integration. Use for any Supabase-related questions including vector search, embeddings, RAG, and semantic search.
 
 ## Structure
 
@@ -27,7 +27,8 @@ supabase/
 | Priority | Category | Impact | Prefix |
 |----------|----------|--------|--------|
 | 1 | Database | CRITICAL | `db-` |
-| 2 | Realtime | MEDIUM-HIGH | `realtime-` |
+| 2 | Vectors | MEDIUM | `vectors-` |
+| 3 | Realtime | MEDIUM-HIGH | `realtime-` |
 
 Reference files are named `{prefix}-{topic}.md` (e.g., `query-missing-indexes.md`).
 
@@ -64,6 +65,16 @@ Reference files are named `{prefix}-{topic}.md` (e.g., `query-missing-indexes.md
 - `references/realtime-setup-auth.md`
 - `references/realtime-setup-channels.md`
 
+**Vectors** (`vectors-`):
+- `references/vectors-embed-generation.md`
+- `references/vectors-index-hnsw.md`
+- `references/vectors-index-ivfflat.md`
+- `references/vectors-perf-tuning.md`
+- `references/vectors-rag-patterns.md`
+- `references/vectors-search-hybrid.md`
+- `references/vectors-search-semantic.md`
+- `references/vectors-setup-pgvector.md`
+
 ---
 
-*27 reference files across 2 categories*
+*35 reference files across 3 categories*

skills/supabase/references/_sections.md

@@ -10,7 +10,12 @@ queries.
 **Impact:** CRITICAL
 **Description:** Row Level Security policies, connection pooling, schema design patterns, migrations, performance optimization, and security functions for Supabase Postgres.
 
-## 2. Realtime (realtime)
+## 2. Vectors (vectors)
+
+**Impact:** MEDIUM
+**Description:** pgvector setup, HNSW/IVFFlat indexing, semantic and hybrid search, embedding generation, RAG patterns, and performance tuning.
+
+## 3. Realtime (realtime)
 
 **Impact:** MEDIUM-HIGH
 **Description:** Channel setup, Broadcast messaging, Presence tracking, Postgres Changes listeners, cleanup patterns, error handling, and debugging.

skills/supabase/references/vectors/_sections.md

@@ -1,36 +0,0 @@
-# Section Definitions
-
-Reference files are grouped by prefix. Claude loads specific files based on user
-queries.
-
----
-
-## 1. Setup (setup)
-
-**Impact:** HIGH
-**Description:** pgvector extension setup, vector column types (vector, halfvec, bit), dimension configuration, and Supabase-specific schema patterns.
-
-## 2. Indexing (index)
-
-**Impact:** CRITICAL
-**Description:** HNSW and IVFFlat index creation, parameter tuning (m, ef_construction, ef_search, lists, probes), operator classes, and concurrent index builds.
-
-## 3. Search (search)
-
-**Impact:** CRITICAL
-**Description:** Semantic search with match_documents functions, hybrid search combining vectors with full-text, RRF scoring, metadata filtering, and RLS integration.
-
-## 4. Embeddings (embed)
-
-**Impact:** HIGH
-**Description:** Embedding generation using gte-small built-in model, OpenAI integration, automatic embeddings with triggers, and Edge Function patterns.
-
-## 5. RAG (rag)
-
-**Impact:** HIGH
-**Description:** Retrieval-Augmented Generation patterns including document ingestion, chunking strategies, query pipelines, and Edge Function architectures.
-
-## 6. Performance (perf)
-
-**Impact:** CRITICAL
-**Description:** Vector search optimization, index pre-warming, compute sizing for vector workloads, batch operations, and query monitoring.