⌘6 Search — find anything across chats and artifacts

./reference
1
🇬🇧 English

Sidebar group: Search · Shortcut: ⌘6 · Single route: /search

Hybrid search (lexical / semantic / hybrid mode) across chats and artifacts of the active project. Returns results ranked by similarity, with the matching snippet highlighted.

What’s in scope

  • Chats: every conversation in the project’s history (unless explicitly excluded from the RAG in /chats)
  • Artifacts: every PRD, epic, user story, AC, decision record, technical spec

Not in scope: source code itself, external references, web search. PaellaDoc indexes its own knowledge.

The three modes

  • Lexical: classic full-text match. Fast, exact, good for finding a specific identifier or string
  • Semantic: vector search via the embedding index. Good for “find me the discussion about authentication” when the word “authentication” was never used
  • Hybrid: weighted combination, default. Tries to give you the best of both

The embedding index state

The search page also shows the state of your embedding index:

  • ready — indexed and queryable
  • indexing — currently building, semantic results may be partial
  • queued — waiting to start
  • degraded — something failed; fallback to lexical-only

If you see degraded, that’s a real signal — check /observability for the error.

When to use it

  • “Where did we decide to use Postgres instead of SQLite?” → semantic, search for “database choice”
  • “Find me every artifact referencing the customer onboarding epic” → lexical, search for the epic name
  • “What did the agent log when it failed last Tuesday on the auth story?” → search the chats with a date filter

Mainly for: all four personas. Search is the only group that’s universal.

🇪🇸 Español

Grupo del sidebar: Search · Atajo: ⌘6 · Ruta única: /search

Búsqueda híbrida (lexical / semántica / híbrida) sobre chats y artefactos del proyecto activo. Devuelve resultados ordenados por similitud, con el snippet coincidente destacado.

Qué entra

  • Chats: toda la conversación en el histórico del proyecto (a menos que se haya excluido explícitamente del RAG en /chats)
  • Artefactos: cada PRD, épica, user story, AC, decision record, technical spec

No entra: el código fuente, referencias externas, búsqueda web. PaellaDoc indexa su propio conocimiento.

Los tres modos

  • Lexical: match clásico full-text. Rápido, exacto, bueno para encontrar un identificador o string concreto
  • Semántica: búsqueda vectorial sobre el índice de embeddings. Buena para “encuéntrame la discusión sobre autenticación” cuando nunca se usó la palabra “autenticación”
  • Híbrida: combinación ponderada, por defecto. Intenta darte lo mejor de ambos

Estado del índice de embeddings

La página de search también muestra el estado de tu índice:

  • ready — indexado y consultable
  • indexing — construyéndose ahora, resultados semánticos pueden ser parciales
  • queued — esperando para empezar
  • degraded — algo falló; fallback a solo lexical

Si ves degraded, eso es una señal real — revisa /observability para el error.

Cuándo usarlo

  • “¿Dónde decidimos usar Postgres en vez de SQLite?” → semántica, buscar “database choice”
  • “Encuéntrame todo artefacto que referencie la épica de onboarding” → lexical, buscar el nombre de la épica
  • “¿Qué logueó el agente cuando falló el martes pasado en la story de auth?” → buscar en chats con filtro de fecha

Principalmente para: las cuatro personas. Search es el único grupo universal.