// DevVerse chat, citation, and retrieval workflow. Use when modifying the chat page, the chat API route, citation parsing, local retrieval fallback, Pinecone or Gemini integration, or the article vectorization pipeline.
MDX article conventions for DevVerse. Use when adding or editing files under content/, changing article metadata, updating author or date lines, or modifying code that parses article content for feeds, related posts, reading stats, or RAG ingestion.
Feed, sitemap, metadata, and publishing guidance for DevVerse. Use when modifying lib/rss.ts, lib/jsonfeed.ts, feed routes, next-sitemap.config.js, app/layout.tsx metadata, manifest or robots files, or SEO-related site metadata.
Refresh Pinecone article embeddings after MDX article changes or RAG chunking and metadata changes. Use when content updates should be reflected in chat retrieval or when the vectorization pipeline changes.
Supabase auth, favorites, and security boundaries for DevVerse. Use when changing files under supabase/, auth or favorites UI, or the verify-email and reset-password API routes.
Route and UI conventions for the DevVerse Next.js app. Use when modifying app routes, layout, navigation, page components, global styling, route-scoped CSS, article rendering, favorites UI, or chat UI.
Run repository-specific validation for DevVerse changes. Use when asked to test, validate, smoke check, or confirm modifications in this repository.
| name | devverse-rag-chat |
| description | DevVerse chat, citation, and retrieval workflow. Use when modifying the chat page, the chat API route, citation parsing, local retrieval fallback, Pinecone or Gemini integration, or the article vectorization pipeline. |
Preserve the response contract between backend and UI.
The UI expects an answer string, a sources array, bracket citations in the answer body, and a trailing Sources: section that it strips before rendering.
Keep citation parsing aligned with UI behavior.
If you change citation formatting, update both lib/chat-citations.ts and the chat UI in the same task.
Preserve hybrid retrieval unless you are intentionally redesigning it.
lib/rag.ts merges Pinecone results with the local lexical fallback from lib/rag-local.ts.
Read the detailed contract before changing retrieval, prompt format, or vector metadata. @references/rag-contract.md
Assume Pinecone vectors are stale after article or chunking changes until vectorization is rerun.
Validate chat changes with both tests and explicit runtime caveats.
Use the devverse-validate skill for automated checks, then note any live env checks you could not perform.