# Indice de documentacion **Proyecto:** Workspace de tools IA para empresas **Ultima actualizacion:** 2026-04-02 **Ultima modificacion por:** Agente tools IA para potenciar servicios empresariales --- ## Proposito Este documento es el mapa de la documentacion activa del workspace. Usalo para: - saber que documentos existen - evitar documentacion duplicada - identificar donde registrar cambios del workspace - mantener limpia la documentacion de este proyecto --- ## Protocolo rapido 1. Lee `docs/README.md` antes de crear o reorganizar documentacion. 2. Verifica aqui si el documento ya existe o si su contenido pertenece a otro archivo. 3. Si creas un documento nuevo, anadelo aqui en la misma sesion. 4. Si limpias documentacion heredada, actualiza este indice para reflejar el estado real. Convencion de estructura: - `docs/` en raiz contiene solo documentacion global del workspace. - cada tool o modulo independiente debe vivir en su propia carpeta raiz. - la documentacion propia de cada tool debe vivir dentro de su carpeta, por ejemplo `RAG/docs/`. --- ## Documentos activos ### `README.md` **Ubicacion:** `docs/README.md` **Proposito:** Reglas base para agentes y criterios de trabajo del workspace. **Cuando leerlo:** - al empezar a trabajar en este workspace - antes de crear o modificar documentacion **Cuando actualizarlo:** - si cambian las reglas del workspace - si se incorporan nuevas normas de documentacion o trabajo --- ### `INDICE_DOCUMENTACION.md` **Ubicacion:** `docs/INDICE_DOCUMENTACION.md` **Proposito:** Inventario maestro de la documentacion vigente. **Cuando leerlo:** - antes de crear un nuevo documento - al revisar estructura documental del workspace **Cuando actualizarlo:** - cuando se crea, elimina o renombra un documento en `docs/` --- ### `HISTORIAL_SESIONES.md` **Ubicacion:** `docs/HISTORIAL_SESIONES.md` **Proposito:** Registro de agentes y sesiones de trabajo de este workspace. **Cuando leerlo:** - al identificar un agente - al revisar continuidad del trabajo anterior **Cuando actualizarlo:** - al registrar una nueva sesion relevante - al dar de alta o ajustar un agente activo --- ### `PENDIENTES_GENERALES.md` **Ubicacion:** `docs/PENDIENTES_GENERALES.md` **Proposito:** Backlog principal de tools, experimentos, investigaciones e integraciones del workspace. **Cuando leerlo:** - al decidir en que trabajar a continuacion - al revisar prioridades del workspace **Cuando actualizarlo:** - cuando aparece una nueva linea de trabajo - cuando cambia el enfoque o estado de una iniciativa --- ### `TASK.md` **Ubicacion:** `docs/TASK.md` **Proposito:** Descomponer lineas de trabajo amplias en bloques de analisis, decisiones y acuerdos para avanzar sin dejar puntos importantes fuera. **Cuando leerlo:** - cuando una linea de trabajo requiera varias conversaciones o decisiones encadenadas - al continuar una planificacion tecnica ya iniciada **Cuando actualizarlo:** - cuando se abra una nueva task de analisis relevante - cuando cambien los puntos a convenir de una task activa --- ### `ACCESOS_INFRAESTRUCTURA_LOCAL.md` **Ubicacion:** `docs/ACCESOS_INFRAESTRUCTURA_LOCAL.md` **Proposito:** Registrar accesos temporales y datos de infraestructura necesarios para auditoria, despliegue y revision operativa del workspace. **Cuando leerlo:** - al necesitar acceder al VPS, EasyPanel o servicios relacionados - al revisar como estan montados servicios de infraestructura como webfetch o qdrant **Cuando actualizarlo:** - cuando se añadan o cambien accesos de infraestructura - cuando se incorporen nuevos entornos o servicios relevantes --- ### `RAG/docs/SISTEMA_RAG_BASE.md` **Ubicacion:** `RAG/docs/SISTEMA_RAG_BASE.md` **Proposito:** Documento marco del sistema RAG base reutilizable que se quiere construir para este workspace y para futuros proyectos. **Cuando leerlo:** - al iniciar el trabajo sobre la linea RAG - al necesitar recordar objetivos, alcance y enfoque del sistema **Cuando actualizarlo:** - cuando cambie la vision del sistema RAG - cuando se definan o ajusten objetivos clave del diseño base --- ### `RAG/docs/INGESTA.md` **Ubicacion:** `RAG/docs/INGESTA.md` **Proposito:** Definir el modulo de ingesta del sistema RAG, su alcance, responsabilidades y preparacion para futuras actualizaciones. **Cuando leerlo:** - al diseñar la entrada de conocimiento al RAG - al decidir como se incorporan y registran las fuentes **Cuando actualizarlo:** - cuando cambie el alcance de la ingesta - cuando se acuerden metadatos, tipos de fuente o comportamiento base --- ### `RAG/docs/PROCESADO.md` **Ubicacion:** `RAG/docs/PROCESADO.md` **Proposito:** Definir el modulo de procesado del RAG, especialmente la preparacion del contenido y la estrategia de chunking. **Cuando leerlo:** - al definir como se transforma el contenido ingerido antes de indexarlo - al trabajar decisiones sobre chunking y estructura recuperable **Cuando actualizarlo:** - cuando se acuerde o cambie la estrategia de chunking - cuando se amplie el tratamiento por tipo de documento o fuente --- ### `RAG/docs/BITACORA_DISENO_RAG.md` **Ubicacion:** `RAG/docs/BITACORA_DISENO_RAG.md` **Proposito:** Mantener una vision panoramica del camino de diseño del RAG, incluyendo decisiones, razonamiento, contexto y opciones abiertas. **Cuando leerlo:** - al retomar la conversacion de diseño del RAG - al necesitar entender por que se eligio una direccion concreta - al querer ver la vision general que da sentido al resto de documentos del modulo **Cuando actualizarlo:** - cuando se cierre una decision relevante de diseño - cuando aparezca un cambio de rumbo, matiz importante u opcion abierta que merezca conservarse --- ### `RAG/docs/SALIDA.md` **Ubicacion:** `RAG/docs/SALIDA.md` **Proposito:** Definir la salida del sistema RAG, especialmente la recuperacion de contexto y la estructura del retrieve inicial. **Cuando leerlo:** - al diseñar como consumiran el RAG agentes, apps o herramientas - al revisar que debe devolver `retrieve` y como debe servir de contexto de arranque **Cuando actualizarlo:** - cuando cambie la estructura de salida del RAG - cuando se ajusten los modos de retrieve, answer o sintesis --- ### `RAG/docs/STACK_TECNICO_V1.md` **Ubicacion:** `RAG/docs/STACK_TECNICO_V1.md` **Proposito:** Documentar el stack tecnico minimo acordado para construir la primera version funcional del RAG. **Cuando leerlo:** - al iniciar la implementacion tecnica del RAG - al revisar decisiones de backend, vector store, parsing y forma de acceso **Cuando actualizarlo:** - cuando cambie alguna decision tecnica base del stack - cuando se cierre o cambie el proveedor inicial de embeddings --- ### `RAG/docs/DESPLIEGUE_EASYPANEL.md` **Ubicacion:** `RAG/docs/DESPLIEGUE_EASYPANEL.md` **Proposito:** Documentar el patron de despliegue del modulo RAG en EasyPanel tomando como referencia los servicios ya montados en `ia_servicios`. **Cuando leerlo:** - al preparar el despliegue de `RAG` en VPS2 - al revisar como conectarlo correctamente con `qdrant` y el proyecto `ia_servicios` **Cuando actualizarlo:** - cuando cambie el patron de despliegue en EasyPanel - cuando el servicio `RAG` quede finalmente publicado y probado en el VPS --- ### `RAG/docs/DUDAS_DESPLIEGUE_WEBFETCH_VPS2.md` **Ubicacion:** `RAG/docs/DUDAS_DESPLIEGUE_WEBFETCH_VPS2.md` **Proposito:** Recoger dudas concretas sobre como se desplego `webfetch` en `VPS2` para reutilizar el patron correcto al publicar `RAG`. **Cuando leerlo:** - al pedir informacion a otro agente o compañero sobre el despliegue actual de `webfetch` - al preparar el despliegue de `RAG` siguiendo el patron de `ia_servicios` **Cuando actualizarlo:** - cuando se reciban respuestas sobre el despliegue de `webfetch` - cuando las dudas queden resueltas y sirvan para desplegar `RAG` --- ### `RAG/docs/API_RAG.md` **Ubicacion:** `RAG/docs/API_RAG.md` **Proposito:** Documentar de forma practica la API del servicio RAG, con endpoints, payloads y ejemplos listos para conectar desde n8n, agentes o aplicaciones. **Cuando leerlo:** - al integrar el RAG desde n8n o cualquier otro cliente HTTP - al necesitar ejemplos listos de `health`, `ingest`, `retrieve` y `answer` **Cuando actualizarlo:** - cuando cambie algun endpoint o payload del servicio - cuando se añadan nuevos modos o patrones de integracion --- ### `RAG/docs/PLAYGROUND.md` **Ubicacion:** `RAG/docs/PLAYGROUND.md` **Proposito:** Documentar la tecnologia, ubicacion y utilidad del playground interno del RAG para pruebas y evaluacion. **Cuando leerlo:** - al querer probar el RAG con interfaz web interna - al revisar por que se eligio esta forma de playground y no otra **Cuando actualizarlo:** - cuando cambie la interfaz de prueba - cuando el playground se amplie o se conecte tambien por MCP --- ### `RAG/docs/LOGS_EVALUACION.md` **Ubicacion:** `RAG/docs/LOGS_EVALUACION.md` **Proposito:** Documentar como se guardan, siguen y revisan los logs de evaluacion del RAG. **Cuando leerlo:** - al revisar logs generados por el playground o por la API - al planificar mejoras del RAG a partir de incidencias registradas **Cuando actualizarlo:** - cuando cambie el esquema o el flujo de revision de logs - cuando se amplie el sistema de evaluacion del RAG --- ### `RAG/docs/METODOLOGIA_ITERACION_Y_REDEPLOY.md` **Ubicacion:** `RAG/docs/METODOLOGIA_ITERACION_Y_REDEPLOY.md` **Proposito:** Documentar la metodologia de trabajo ya validada para implementar, probar, subir y redeplegar mejoras del RAG sin reinventar el flujo en cada sesion. **Cuando leerlo:** - al continuar el trabajo del RAG desde una nueva sesion - al necesitar saber cuando un cambio ya esta listo para pedir `Deploy` al usuario **Cuando actualizarlo:** - cuando cambie el flujo operativo de iteracion, validacion o despliegue - cuando se detecte una mejora estable en la metodologia de trabajo --- ### `RAG/docs/AGENTE_GSTREAMER.md` **Ubicacion:** `RAG/docs/AGENTE_GSTREAMER.md` **Proposito:** Documentar el agente `gstreamer` de OpenCode, su scope documental por defecto, su comportamiento esperado y su orientacion a diagnostico tecnico sobre proyectos con GStreamer. **Cuando leerlo:** - al usar o ajustar el agente `gstreamer` - al revisar como debe apoyarse en el RAG de GStreamer y como debe comportarse frente a cambios de codigo **Cuando actualizarlo:** - cuando cambie el prompt o el comportamiento del agente - cuando se amplie para soportar cambio dinamico de scope u otros corpus del RAG --- ### `RAG/docs/AGENTE_GSTREAMER_OPENCODE.jsonc` **Ubicacion:** `RAG/docs/AGENTE_GSTREAMER_OPENCODE.jsonc` **Proposito:** Bloque portable de configuracion del agente `gstreamer` para instalarlo en otra instancia de OpenCode. **Cuando leerlo:** - al querer replicar el agente `gstreamer` en otro PC - al necesitar copiar exactamente su configuracion de OpenCode **Cuando actualizarlo:** - cuando cambie el prompt o comportamiento efectivo del agente - cuando cambie la configuracion de permisos o modo del agente --- ### `RAG/docs/INSTALAR_AGENTE_GSTREAMER_EN_OTRO_PC.md` **Ubicacion:** `RAG/docs/INSTALAR_AGENTE_GSTREAMER_EN_OTRO_PC.md` **Proposito:** Explicar como instalar el agente `gstreamer` en otro PC, tanto manualmente como usando otro agente OpenCode. **Cuando leerlo:** - al migrar el agente `gstreamer` a otro equipo - al querer reinstalarlo o automatizar su despliegue local **Cuando actualizarlo:** - cuando cambie el proceso de instalacion del agente - cuando se añada una integracion real con el RAG remoto --- ### `RAG/scripts/rag_gstreamer_bootstrap.sh` **Ubicacion:** `RAG/scripts/rag_gstreamer_bootstrap.sh` **Proposito:** Consultar el RAG remoto de GStreamer con `intent=bootstrap`, fijado al scope `gstreamer-official`. **Cuando leerlo:** - al revisar como el agente `gstreamer` se conecta realmente al RAG remoto - al portar la integracion a otro PC **Cuando actualizarlo:** - cuando cambie el endpoint del RAG - cuando cambie el scope o el payload de bootstrap --- ### `RAG/scripts/rag_gstreamer_retrieve.sh` **Ubicacion:** `RAG/scripts/rag_gstreamer_retrieve.sh` **Proposito:** Consultar el RAG remoto de GStreamer con `intent=specific`, fijado al scope `gstreamer-official`. **Cuando leerlo:** - al revisar como el agente `gstreamer` se conecta realmente al RAG remoto - al portar la integracion a otro PC **Cuando actualizarlo:** - cuando cambie el endpoint del RAG - cuando cambie el scope o el payload de retrieve --- ### `sesion_actual_opencode.md` **Ubicacion:** `docs/sesion_actual_opencode.md` **Proposito:** Instruccion universal para detectar la sesion activa de OpenCode del workspace actual. **Cuando leerlo:** - al necesitar identificar `session_id`, titulo y directorio de la sesion actual **Cuando actualizarlo:** - solo si el usuario lo pide expresamente o cambia el mecanismo canonico de deteccion --- ## Estado actual de la documentacion - La documentacion global del workspace esta concentrada en `docs/`. - La documentacion especifica de cada tool debe vivir dentro de su propio modulo raiz. - Se ha eliminado el arrastre documental de proyectos anteriores en los archivos base. - Cualquier documento nuevo debe responder al objetivo de tools IA para empresas. --- ## Estadistica global **Total de documentos indexados:** 24