# Vasallo94 Obsidianrag RAG Architect

> RAG & LangGraph Architect

- Skill: `tomevault-io/vasallo94-obsidianrag-rag-architect` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/vasallo94-obsidianrag-rag-architect`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/vasallo94-obsidianrag-rag-architect/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/vasallo94-obsidianrag-rag-architect

---


# RAG & LangGraph Architect

## Cuándo usar esta skill
- Cuando necesites modificar el flujo de preguntas y respuestas.
- Cuando quieras cambiar la lógica de retrieval (BM25, Vector, Reranker).
- Cuando ajustes los prompts del sistema o del LLM.
- Cuando implementes nuevos nodos en el grafo de LangGraph.

## Cómo usar esta skill

### 1. Arquitectura del Grafo
El agente usa `LangGraph` con el estado `AgentState`.
**Flujo**: `START` -> `retrieve` -> `generate` -> `END`

### 2. Implementación de Nodos

#### Retrieve Node
Usa búsqueda híbrida (EnsembleRetriever) + Reranker opcional + Expansión de GraphRAG (wikilinks).
- Ubicación: `obsidianrag/core/qa_agent.py` y `qa_service.py` (si existe split).

#### Generate Node
Construye el prompt con contexto formateado y llama a Ollama via `ChatOllama`.

### 3. GraphRAG Link Expansion
La función clave es `expand_linked_documents`. Busca notas enlazadas mediante `[[wikilinks]]` en los documentos recuperados y las añade al contexto.

### 4. Prompt Engineering
Los prompts están definidos como `ChatPromptTemplate`.
- Sé explícito sobre el rol.
- Pide citas de las notas fuente.
- Maneja el caso "No lo sé".

### 5. Debugging
Para ver qué documentos se recuperan, puedes ajustar el nivel de log a DEBUG en `utils/logger.py` o inspeccionar el estado intermedio del grafo.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/vasallo94) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->

