From 6bbc7d3fd28acc0de9c5d27fa81d4f6043b7d02b Mon Sep 17 00:00:00 2001 From: Pedro Rodrigues Date: Mon, 9 Feb 2026 19:28:53 +0000 Subject: [PATCH] refactor: flatten vectors references to root references directory Co-Authored-By: Claude Opus 4.6 --- skills/supabase/AGENTS.md | 17 +++++++-- skills/supabase/references/_sections.md | 7 +++- ...eration.md => vectors-embed-generation.md} | 0 .../index-hnsw.md => vectors-index-hnsw.md} | 0 ...ex-ivfflat.md => vectors-index-ivfflat.md} | 0 .../perf-tuning.md => vectors-perf-tuning.md} | 0 ...ag-patterns.md => vectors-rag-patterns.md} | 0 ...rch-hybrid.md => vectors-search-hybrid.md} | 0 ...semantic.md => vectors-search-semantic.md} | 0 ...-pgvector.md => vectors-setup-pgvector.md} | 0 .../supabase/references/vectors/_sections.md | 36 ------------------- 11 files changed, 20 insertions(+), 40 deletions(-) rename skills/supabase/references/{vectors/embed-generation.md => vectors-embed-generation.md} (100%) rename skills/supabase/references/{vectors/index-hnsw.md => vectors-index-hnsw.md} (100%) rename skills/supabase/references/{vectors/index-ivfflat.md => vectors-index-ivfflat.md} (100%) rename skills/supabase/references/{vectors/perf-tuning.md => vectors-perf-tuning.md} (100%) rename skills/supabase/references/{vectors/rag-patterns.md => vectors-rag-patterns.md} (100%) rename skills/supabase/references/{vectors/search-hybrid.md => vectors-search-hybrid.md} (100%) rename skills/supabase/references/{vectors/search-semantic.md => vectors-search-semantic.md} (100%) rename skills/supabase/references/{vectors/setup-pgvector.md => vectors-setup-pgvector.md} (100%) delete mode 100644 skills/supabase/references/vectors/_sections.md diff --git a/skills/supabase/AGENTS.md b/skills/supabase/AGENTS.md index 82379ec..a38c361 100644 --- a/skills/supabase/AGENTS.md +++ b/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* \ No newline at end of file +*35 reference files across 3 categories* \ No newline at end of file diff --git a/skills/supabase/references/_sections.md b/skills/supabase/references/_sections.md index dfa9a6d..8950891 100644 --- a/skills/supabase/references/_sections.md +++ b/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. diff --git a/skills/supabase/references/vectors/embed-generation.md b/skills/supabase/references/vectors-embed-generation.md similarity index 100% rename from skills/supabase/references/vectors/embed-generation.md rename to skills/supabase/references/vectors-embed-generation.md diff --git a/skills/supabase/references/vectors/index-hnsw.md b/skills/supabase/references/vectors-index-hnsw.md similarity index 100% rename from skills/supabase/references/vectors/index-hnsw.md rename to skills/supabase/references/vectors-index-hnsw.md diff --git a/skills/supabase/references/vectors/index-ivfflat.md b/skills/supabase/references/vectors-index-ivfflat.md similarity index 100% rename from skills/supabase/references/vectors/index-ivfflat.md rename to skills/supabase/references/vectors-index-ivfflat.md diff --git a/skills/supabase/references/vectors/perf-tuning.md b/skills/supabase/references/vectors-perf-tuning.md similarity index 100% rename from skills/supabase/references/vectors/perf-tuning.md rename to skills/supabase/references/vectors-perf-tuning.md diff --git a/skills/supabase/references/vectors/rag-patterns.md b/skills/supabase/references/vectors-rag-patterns.md similarity index 100% rename from skills/supabase/references/vectors/rag-patterns.md rename to skills/supabase/references/vectors-rag-patterns.md diff --git a/skills/supabase/references/vectors/search-hybrid.md b/skills/supabase/references/vectors-search-hybrid.md similarity index 100% rename from skills/supabase/references/vectors/search-hybrid.md rename to skills/supabase/references/vectors-search-hybrid.md diff --git a/skills/supabase/references/vectors/search-semantic.md b/skills/supabase/references/vectors-search-semantic.md similarity index 100% rename from skills/supabase/references/vectors/search-semantic.md rename to skills/supabase/references/vectors-search-semantic.md diff --git a/skills/supabase/references/vectors/setup-pgvector.md b/skills/supabase/references/vectors-setup-pgvector.md similarity index 100% rename from skills/supabase/references/vectors/setup-pgvector.md rename to skills/supabase/references/vectors-setup-pgvector.md diff --git a/skills/supabase/references/vectors/_sections.md b/skills/supabase/references/vectors/_sections.md deleted file mode 100644 index ffd3791..0000000 --- a/skills/supabase/references/vectors/_sections.md +++ /dev/null @@ -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.