34 lines
1.9 KiB
Markdown
34 lines
1.9 KiB
Markdown
# 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.
|