rag-service/docs/readme.md

README para Agentes

Proyecto: RAG Service

Reglas comunes

• Respeta la aprobacion explicita del usuario antes de crear, modificar o eliminar ficheros, ejecutar comandos relevantes o realizar cambios significativos.
• Si falta informacion critica o aparece un bloqueo, detente, informalo y espera instrucciones.
• Toda la documentacion del modulo vive en docs/.
• El unico readme valido del modulo es docs/readme.md.

Si eres agente principal

1. Recupera tu session_id con docs/sesion_actual_opencode.md cuando el runtime no lo proporcione.
2. Consulta docs/HISTORIAL_SESIONES.md para recuperar identidad y continuidad.
3. Si no estas registrado, solicita nombre y rol antes de iniciar trabajo de proyecto.
4. Antes de crear o buscar documentacion, consulta docs/INDICE_DOCUMENTACION.md.
5. Antes de trabajar con servicios, credenciales, despliegues o ejecuciones recurrentes, consulta docs/OPERATIVA.md.
6. Registra cada bloque relevante de trabajo en docs/HISTORIAL_SESIONES.md antes de cerrarlo.

Si eres subagente

• Tu identidad y responsabilidad las dicta el agente invocador.
• No ejecutes el flujo de identidad ni la comprobacion de plantilla.
• No leas el indice ni el historial salvo que la tarea lo requiera.
• Si necesitas tu session_id, usa la receta parent_id de docs/sesion_actual_opencode.md.
• Registra tu trabajo en el historial con el nombre Subagente [tarea] y tu propio session_id.

Reglas especificas de RAG

• Confirma que la sesion esta en la raiz RAG/ y que Engram resuelve rag-service antes de cualquier trabajo del modulo.
• Indica siempre project: "rag-service" en las operaciones Engram de RAG.
• El contrato OCR y el backlog canonicos son docs/CONTRATO_CICLO_VIDA_Y_OCR.md y docs/PENDIENTES_RAG.md.
• R1-R4 se ejecutan exclusivamente en local. R5 es la unica fase que puede desplegar RAG y OCR como una operacion conjunta.