# 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` --- ### `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:** 15