Lumina RAG Knowledge

Lumina Rag Knowledge

Overview

Use this skill for retrieval, ingestion, and citation work. The repository treats knowledge management as a CLI-driven flow rather than a UI-managed feature.

Load The Right Reference

• Read references/cli-workflow.md when updating or using ingestion commands, manifests, or source files.
• Read references/retrieval-contract.md when changing runtime retrieval, citation formatting, or grounded-answer behavior.

Preserve The Grounding Contract

• Keep answers grounded in indexed sources.
• Preserve inline citations and the associated sources list behavior when changing retrieval or response composition.
• Avoid adding UI-based mutation flows for knowledge content unless the task explicitly requires a product change.
• Prefer updating source content through the CLI and manifest workflows already documented in the repo.

Change Source Lifecycle Carefully

• Preserve stable externalId usage when designing repeatable updates.
• Keep ingestion, deletion, listing, and sync semantics coherent across CLI commands and model storage.
• If a change affects both retrieval logic and general API behavior, coordinate with lumina-backend-api.

Finish With Practical Validation

• Run npm run build in server/ after code changes.
• Use the existing CLI commands for targeted runtime checks when environment variables and external services are available.
• If Pinecone or Gemini credentials are unavailable, state that runtime retrieval was not exercised.