# 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.