Document OpenCode GStreamer agent configuration

RAG/docs/AGENTE_GSTREAMER.md

@@ -0,0 +1,135 @@
+# Agente GStreamer
+
+**Proyecto:** Workspace de tools IA para empresas  
+**Modulo:** RAG  
+**Ultima actualizacion:** 2026-04-09  
+**Ultima modificacion por:** Agente RAG 2  
+**Estado:** Activo
+
+---
+
+## Proposito
+
+Documentar el agente `gstreamer` configurado en OpenCode para trabajo tecnico especializado sobre proyectos que usan GStreamer.
+
+El objetivo del agente no es ser un asistente generalista, sino un agente operativo para:
+
+- revisar codigo
+- diagnosticar errores
+- proponer correcciones
+- y, solo si se le pide, aplicar y validar cambios
+
+apoyandose de forma prioritaria en el RAG del corpus oficial de GStreamer.
+
+---
+
+## Nombre del agente
+
+```text
+gstreamer
+```
+
+Debe aparecer como agente primario seleccionable junto con otros modos primarios del entorno OpenCode.
+
+---
+
+## Base de conocimiento principal
+
+El agente debe priorizar siempre el scope del RAG cargado para GStreamer:
+
+- `sourceId`: `corpus:gstreamer:official:v1`
+- `sourceRef`: `gstreamer-official`
+
+Este scope contiene la documentacion oficial de GStreamer ya ingerida y validada.
+
+Regla operativa:
+
+- primero apoyarse en el RAG de GStreamer
+- despues complementar con conocimiento interno del modelo cuando ayude
+- no depender de busquedas web
+
+---
+
+## Enfoque tecnico del agente
+
+### Dominio principal
+
+- GStreamer
+- integracion en aplicaciones reales
+- diagnostico de pipelines
+- uso de elementos, pads, caps, states, bus, negotiation y ciclo de vida
+
+### Lenguaje principal esperado
+
+- C++
+
+Aunque puede trabajar con otros lenguajes si aparecen, su orientacion principal debe ser revision tecnica de codigo C++ que integre GStreamer.
+
+---
+
+## Comportamiento esperado
+
+### Por defecto
+
+El agente debe:
+
+- diagnosticar
+- explicar el problema
+- proponer cambios
+- justificar los cambios propuestos
+
+### No debe hacer por defecto
+
+- editar ficheros automaticamente
+- aplicar fixes sin permiso
+- modificar codigo solo por detectar un posible error
+
+### Si el usuario lo pide explicitamente
+
+Entonces si puede:
+
+- editar ficheros
+- compilar
+- ejecutar comandos
+- lanzar pruebas
+- validar si el error parece resuelto
+
+---
+
+## Forma recomendada de uso
+
+El agente funciona mejor cuando recibe:
+
+- ficheros o modulos concretos
+- sintomas observados
+- logs de error
+- mensajes del bus de GStreamer
+- comportamiento esperado frente al comportamiento real
+
+No conviene pedirle que revise una aplicacion enorme de una sola vez sin contexto adicional.
+
+---
+
+## Restricciones intencionadas
+
+En la configuracion actual del agente:
+
+- `webfetch`: denegado
+- `websearch`: denegado
+
+Asi se fuerza que el agente se apoye sobre todo en:
+
+- el RAG de GStreamer
+- el codigo local
+- el conocimiento interno del modelo
+
+---
+
+## Evolucion futura prevista
+
+Posibles mejoras futuras:
+
+1. Permitir cambiar de scope entre varios corpus del mismo RAG.
+2. Hacer visible la eleccion de scope desde el propio agente.
+3. Ajustar el agente a flujos de prueba automatizada del proyecto donde se use GStreamer.
+4. Afinar su prompt segun comportamiento real con modelos locales como `gemma4` o `qwen3.5`.

RAG/docs/HISTORIAL_SESIONES.md

@@ -56,3 +56,5 @@ Dar continuidad al RAG en `RAG/` a partir del estado actual documentado.
 - Correccion aplicada en `src/modules/process/chunking.ts` y endurecimiento defensivo de `src/modules/embeddings/provider.ts`.
 - Ingesta completada del corpus GStreamer bajo el scope unico `gstreamer-official` / `corpus:gstreamer:official:v1` con `3117` documentos y `22003` chunks.
 - Validacion funcional en produccion mediante `GET /sources` y `POST /retrieve` para bootstrap y consulta especifica sobre request pads.
+- Creacion y configuracion del agente primario `gstreamer` en OpenCode para diagnostico tecnico sobre proyectos con GStreamer, priorizando el scope `gstreamer-official` del RAG.
+- Documentacion del agente en `RAG/docs/AGENTE_GSTREAMER.md`.

docs/HISTORIAL_SESIONES.md

@@ -11,6 +11,7 @@ Este archivo registra agentes y sesiones de trabajo de este workspace.
 | Agente | Responsabilidad | Identificador |
 |--------|-----------------|---------------|
 | **Agente tools IA para potenciar servicios empresariales** | Desarrollo de tools, herramientas, skills, RAGs, MCPs y utilidades para potenciar soluciones con IA para empresas | `session_id OpenCode por workspace cuando aplique` |
+| **Agente RAG 2** | Continuidad operativa y evolutiva del modulo `RAG/`, incluyendo codigo, pruebas y documentacion del servicio | `ses_29bdbd003ffeLrLjUlFgnp08Y7` |
 
 ---
 
@@ -69,6 +70,8 @@ Este archivo registra agentes y sesiones de trabajo de este workspace.
 - Implementacion de logs de evaluacion persistentes en `Qdrant`, con disparo automatico por contexto insuficiente y registro manual con nota desde el playground.
 - Ampliacion de los logs de evaluacion para permitir seguimiento real (`pending`, `resolved`, `ignored`, etc.) y documentacion de su arquitectura en `RAG/docs/LOGS_EVALUACION.md`.
 - Ajuste visual del playground con branding de POR-CORREO, nuevo titulo y contador visible de logs para detectar de un vistazo actividad de evaluacion.
+- Creacion de `RAG/docs/METODOLOGIA_ITERACION_Y_REDEPLOY.md` para dejar explicito el flujo ya validado de implementacion, prueba local, commit, push y redeploy en EasyPanel.
+- Creacion de `RAG/docs/TEXTOS_AYUDA_PLAYGROUND.md` y nueva task asociada para que otro agente implemente ayuda visual y textos ALT en los botones principales del playground.
 - Reorganizacion de RAG como modulo raiz independiente con documentacion propia en `RAG/docs/`.
 - Ajuste del indice documental global para reflejar la separacion entre documentacion global y documentacion por tool.
 - Creacion de `docs/TASK.md` para descomponer lineas de trabajo amplias en puntos de analisis y acuerdos.
@@ -88,9 +91,38 @@ Este archivo registra agentes y sesiones de trabajo de este workspace.
 
 ---
 
+### Sesion 2 (2026-04-06) - Agente RAG 2
+**Agente:** **Agente RAG 2**  
+**Modelo:** gpt-5.4  
+**Conversation ID:** `N/D (OpenCode no lo expone en este entorno)`  
+**Session ID OpenCode:** `ses_29bdbd003ffeLrLjUlFgnp08Y7`  
+**Titulo de sesion:** `Continuación de proyecto Agente RAG 2`  
+**Directorio:** `/home/pancho/Documentos/Empresa/Desarrollo/IA`
+
+#### Trabajo realizado:
+- Lectura del `docs/README.md` global del workspace para alinear reglas de documentacion y registro.
+- Revision de `docs/HISTORIAL_SESIONES.md` y `docs/sesion_actual_opencode.md` como base operativa de continuidad.
+- Revision inicial de la documentacion principal del modulo `RAG/` para retomar el estado de la v1.
+- Registro de continuidad como `Agente RAG 2` orientado especificamente al trabajo sobre `RAG/`.
+- Creacion de `RAG/docs/HISTORIAL_SESIONES.md` como historial interno del modulo para trazabilidad local entre sesiones del propio RAG.
+- Configuracion del agente primario `gstreamer` en OpenCode para trabajo especializado con el RAG de GStreamer.
+- Indexacion y documentacion del comportamiento del agente `gstreamer`.
+
+#### Estado final:
+- `Agente RAG 2` registrado en el historial global del workspace.
+- Contexto global del workspace alineado con el contexto especifico de `RAG/`.
+- Sesion actual identificada con su `session_id` real de OpenCode.
+
+---
+
 ## Agentes activos
 
 ### Agente tools IA para potenciar servicios empresariales
 - **Responsabilidad:** Desarrollo de tools, herramientas, skills, RAGs, MCPs y utilidades para potenciar soluciones con IA para empresas.
 - **Estado:** Activo
 - **Trabajo principal:** Desarrollo de herramientas reutilizables e integraciones para potenciar otros servicios de IA empresariales.
+
+### Agente RAG 2
+- **Responsabilidad:** Continuidad operativa y evolutiva del modulo `RAG/`, incluyendo backend, playground, retrieval, answer, logs y documentacion del servicio.
+- **Estado:** Activo
+- **Trabajo principal:** Retomar y hacer avanzar el proyecto `RAG/` sin perder continuidad entre sesiones.

docs/INDICE_DOCUMENTACION.md

@@ -323,6 +323,40 @@ Documentar como se guardan, siguen y revisan los logs 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
+
+---
+
 ### `sesion_actual_opencode.md`
 
 **Ubicacion:** `docs/sesion_actual_opencode.md`
@@ -349,4 +383,4 @@ Instruccion universal para detectar la sesion activa de OpenCode del workspace a
 
 ## Estadistica global
 
-**Total de documentos indexados:** 18
+**Total de documentos indexados:** 20