Para llevar a cabo la elaboración de tu \*paper* con la metodología **PRISMA*\*
(Preferred Reporting Items for Systematic Reviews and Meta-Analyses) utilizando
una arquitectura multi-agente, te recomiendo diseñar una estructura clara de
responsabilidades, flujos de trabajo e interacción humana.

A continuación, se detalla el paso a paso y la arquitectura de agentes
recomendada para coordinar el trabajo entre las carpetas de tu proyecto:

\---

# \## 1. Arquitectura y Roles de los Sub-Agentes

1\.  * Agente Orquestador (Master / Workflow Manager):*

\* **Función:*\* Dirige el flujo de trabajo global y coordina el paso de tareas
de un sub-agente a otro.

\* **Configuración:*\* Lee las claves de API desde \`opencode.json` (OpenAlex,
Scopus) y pasa las configuraciones o tokens correspondientes a los sub-agentes
según el paso actual del método PRISMA (Identificación $\\rightarrow$ Tamizaje
/ Selección $\\rightarrow$ Elegibilidad $\\rightarrow$ Inclusión / Escritura).

2\. **Sub-Agente 1: Investigador y Buscador de Literatura (\*Literature Search
Agent*):**

\* **Función:*\* Ejecuta consultas (\*search queries*) usando las API de
OpenAlex y Scopus sobre *"UAV Truck Urban Logistics"* (drones + camiones +
logística urbana).

\* **Entradas/Salidas:*\*

\* Guarda los resultados crudos obtenidos (JSON/BibTeX) en \`data_raw/`.

\* Filtra duplicados y genera un archivo unificado de candidatos preliminares
en \`data_processed/` (por ejemplo, \\`candidates.json` o \\`
prisma_identification.csv`).

3\. **Sub-Agente 2: Evaluador Interactivo / Interfaz Humana (\*Human-in-the-Loop
Screening Agent*):**

\* **Función:*\* Aplica criterios preliminares de inclusión/exclusión y presenta
al usuario la lista de artículos encontrados.

\* **Mecánica:*\*

\* Muestra el título, autores, año, \*abstract* y palabras clave.

\* Pregunta explícitamente al usuario si aprueba o rechaza el artículo (o si se
incluye en la revisión sistemática).

\* Registra la decisión del usuario y los motivos de exclusión/inclusión en
\`data_processed/prisma_flow.json` para generar posteriormente el **Diagrama de
Flujo PRISMA*\*.

4\. **Sub-Agente 3: Redactor LaTeX (\*LaTeX Writer Agent*):**

\* **Función:*\* Toma la lista final de artículos incluidos, analiza/sintetiza
sus metodologías, aportes y resultados en el contexto de "UAV Truck Urban
Logistics", y redacta las secciones del artículo en archivos `.tex` dentro de la
carpeta \`src_latex/`.

\* **Entradas/Salidas:*\*

\* Genera/actualiza las referencias en un archivo \`src_latex/references.bib`.

\* Crea secciones estandarizadas de PRISMA: Introducción, Metodología (Diagrama
PRISMA), Resultados/Taxonomía del estado del arte, Discusión y Conclusiones.

\* Si genera gráficos o esquemas (como el diagrama de flujo PRISMA en
TikZ/PDF), guarda las imágenes o gráficos auxiliares en \`images/`.

\---

# 2\. Estructura de Trabajo por Carpetas

\* **`opencode.json`\**: Almacena las claves API (OpenAlex, Scopus) e
instrucciones de modelos.

\* **`config_ai/`\**: Configuración de prompts, criterios de inclusión/exclusión
y definiciones de agentes.

\* **`data_raw/`\**: Almacenamiento de respuestas crudas de OpenAlex y Scopus
(fase de Identificación de PRISMA).

\* **`data_processed/`\**: Artículos unificados, tablas comparativas
estructuradas y el registro de decisiones del usuario.

\* **`code_r/`\**: Entorno para ejecutar análisis bibliométricos opcionales en R
(e.g., con el paquete \`bibliometrix`) o procesar datos.

\* **`images/`\**: Diagrama de flujo PRISMA (PNG, PDF o soporte TikZ), gráficos
comparativos de publicaciones por año, taxonomías, etc.

\* **`src_latex/`\**: Archivos del documento (\`main.tex`, \\`sections/`, \\`
references.bib`, etc.).

\---

\### 3. Paso a Paso Recomendado para Proceder

1\. **Definición de la Consulta y Criterios PRISMA (\`config_ai/`):*\*

\* Define las ecuaciones de búsqueda (\*search strings*) con palabras clave
como: `("UAV" OR "drone") AND ("truck" OR "vehicle") AND ("urban logistics" OR
"last-mile delivery")`.

\* Establece los criterios explícitos de Inclusión / Exclusión (rango de años,
idioma, tipo de publicación).

2\. **Ejecución de la Búsqueda Automática (Orquestador $\\rightarrow$ Sub-Agente
1):*\*

\* El orquestador ejecuta el Sub-Agente 1 leyendo las credenciales de
\`opencode.json`.

\* El agente realiza las peticiones HTTP a OpenAlex y Scopus, elimina
duplicados por DOI/título y guarda los datos unificados en \`data_processed/`.

3\. **Fase de Tamizaje Interactivo (Sub-Agente 2):*\*

\* Ejecuta la sesión interactiva en la que el Sub-Agente 2 te presenta cada
artículo candidateado.

\* Responde confirmando o rechazando la inclusión de cada referencia.

4\. **Síntesis y Taxonomía del Estado del Arte:*\*

\* Una vez seleccionados los artículos, utiliza scripts de análisis (o llamadas
al modelo) para categorizar las publicaciones (e.g., modelos de ruteo VRP-UAV,
optimización multiobjetivo, legislación urbana, impacto ambiental).

5\. **Generación del Documento en LaTeX (Sub-Agente 3):*\*

\* El Sub-Agente 3 escribe la estructura base en \`src_latex/main.tex`:

\* **Introducción:*\* Justificación del uso combinado de camiones y UAVs en
logística urbana.

\* **Metodología PRISMA:*\* Descripción detallada de las cadenas de búsqueda,
bases de datos y diagrama de flujo PRISMA.

\* **Taxonomía y Clasificación del Estado del Arte:*\* Revisión temática
detallada de la literatura seleccionada.

\* **Brechas de Investigación y Trabajo Futuro (\*Research Gaps*).**

\* **Conclusiones.*\*

\* Actualiza automáticamente \`references.bib` con los datos BibTeX extraídos
de los artículos aceptados.

