HERMES RESEARCH PACK / DOCKER / V2026.7.20
No instalas un prompt. Instalas una operación científica.
Hermes Research Pack añade a Hermes un flujo completo de revisión sistemática: onboarding por Telegram o CLI, protocolo, búsqueda, full text, lectura estructurada, síntesis, revisión independiente y paquete editorial.
Se instala con Docker, se valida en limpio y conserva el estado fuera de la conversación.
Instala el proceso, no una colección de prompts.
Hermes Research Pack convierte una instalación de Hermes en un entorno reproducible para iniciar, ejecutar, reanudar y empaquetar una revisión.
El paquete reúne un gateway público, una plantilla metodológica, skills research, un watchdog persistente, un worker documental opcional y un gate de publicación. La persona usa seis comandos de Telegram o un wrapper CLI; el runtime conserva protocolo, corpus, decisiones, evidencia y entregables en el workspace.
bash install.shdoctorsmoke-testTelegram o CLI01 / PROCESO COMPLETO
Doce fases. Un único estado material.
La persona define el contrato una vez. El runtime mueve la revisión, escribe cada decisión en disco y sabe qué debe ejecutar después de una interrupción.
-
01
INTAKE
Del tema a una frontera investigable
El wizard de
/nueva_revisionpregunta tema, años, criterios, pregunta, campo, rango de N y datos editoriales opcionales. Solo materializa la revisión después de mostrar el resumen y recibir confirmación.PRUEBAprotocol/intake.md -
02
DESCOMPOSICIÓN
Una pregunta principal, varias rutas de búsqueda
La pregunta se divide en constructos, relaciones, contextos, mecanismos, poblaciones y sinónimos. Las consultas amplían la cobertura sin dejar de representar el problema original.
PRUEBAprotocol/research-question.md -
03
PROTOCOLO
Las reglas se escriben antes del primer resultado
Inclusión, exclusión, fuentes, campos mínimos y límites de calidad quedan materializados. Así puede localizarse si un sesgo nace en la pregunta, en la búsqueda o en la interpretación.
PRUEBAprotocol/eligibility-criteria.md -
04
ADQUISICIÓN
Búsqueda multifuente con memoria
OpenAlex, Crossref, Semantic Scholar, arXiv y las fuentes configuradas se recorren con consultas registradas. Motor, fecha, cadena y resultados quedan disponibles para repetir o ampliar la búsqueda.
PRUEBAsearches/search-log.csv -
05
DOI-FIRST
Identidad bibliográfica antes de interpretar
Los registros se normalizan por DOI, se deduplican y se separan los metadatos ambiguos. Hermes no inventa identificadores publicables ni cuenta dos veces el mismo estudio.
PRUEBArecords/master-records.csv -
06
CRIBADO
OK, KO o necesita más evidencia
Título y resumen forman el primer corte. El texto completo decide el umbral real. Cada inclusión o exclusión conserva criterio, razón, detalle, score y confianza para poder recomputar el flujo.
PRUEBAscreening/full-text.csv -
07
FULL TEXT
Sin PDF legible no hay evidencia focal
Hermes recupera el documento, valida que corresponda al DOI, conserva su procedencia y calcula un hash. Un abstract prometedor no sustituye el contenido que sostiene método, resultados y limitaciones.
PRUEBAfulltext/pdf/ -
08
LECTURA CIENTÍFICA
Reconstruye el paper antes de convertirlo en datos
Poppler obtiene una capa rápida. Docling recompone columnas, OCR, tablas, figuras y orden de lectura. Después se localizan objetivo, diseño, muestra, variables, resultados, límites y evidencia por página.
Abrir el proceso de lectura ↓PRUEBAfulltext/docling/<doi>.json -
09
EXTRACCIÓN PROFUNDA
Leer comprende. Extraer permite comparar.
Cada estudio produce una ficha explicativa y campos normalizados. El contrato cambia según medicina, educación, management, ciencias sociales, ingeniería o un diseño mixto.
PRUEBAextraction/extraction-table.csv -
10
EVALUACIÓN
Calidad, relevancia y representatividad no son lo mismo
Las reglas mínimas separan elegibilidad de comparación intensiva. La selección focal combina ajuste temático, calidad metodológica y diversidad, y comprueba su estabilidad con variantes de sensibilidad.
PRUEBAselection/ultraquality-shortlist.csv -
11
SÍNTESIS Y ESCRITURA
El corpus debe producir una tesis, no una lista
La revisión distingue certeza, señal y vacío; propone una unidad de comparación, construye una gramática analítica y deriva implicaciones, amenazas y líneas futuras desde la evidencia observada.
PRUEBApaper/sections/ -
12
REVISIÓN Y CIERRE
Un manuscrito existente todavía no es un trabajo terminado
Revisores independientes, auditoría de integridad y gate editorial comprueban coherencia, citas, artefactos y bloqueos. El ciclo solo cierra cuando existe paquete publicable y el estado global es PASS.
PRUEBApaper/audit/publication-gate.md
02 / WORKER DOCUMENTAL
El producto no envía un PDF roto a un modelo y espera lo mejor.
Poppler mantiene una ruta rápida y determinista. El perfil Docling se ejecuta aislado, reconstruye el documento focal y devuelve Markdown y JSON auditables.
Verificación material
DOI, fuente, formato, legibilidad, páginas y hash exacto del PDF.
Reconstrucción documental
Orden de columnas, OCR, encabezados, tablas, figuras y bloques de lectura.
Lectura funcional
Objetivo, teoría, diseño, muestra, método, variables, resultados y límites.
Anclaje de evidencia
Cada afirmación importante conserva fragmento, tabla, figura o página.
Ficha razonada
Dos párrafos por estudio: diseño y método; después hallazgo, aporte y límite.
Normalización comparativa
La lectura se transforma en variables comunes sin borrar diferencias sustantivas.
Si abstract, método, tablas y conclusiones no coinciden, Hermes registra la discrepancia. No convierte una ausencia en un cero ni completa silenciosamente lo que el paper no reporta.
03 / ROUTER METODOLÓGICO
El runtime cambia de contrato cuando cambia la ciencia.
El intake puede declarar el campo o permitir que Hermes lo infiera. A partir de ahí cambian la extracción, la evaluación crítica, las tablas, las figuras y las señales de riesgo.
Biomédico
Población, intervención, comparador, outcomes y riesgo de sesgo.
Técnico
Arquitectura, dataset, benchmark, métricas, ablation y reproducibilidad.
Ciencias sociales
Constructo, mecanismo, contexto, medición y alcance inferencial.
Educación
Actor, intervención, instrumento, resultado pedagógico y transferencia.
Management
Nivel de análisis, estrategia, entorno, desempeño y límite causal.
Mixto
Integración entre diseños, convergencia de evidencia y contradicciones.
04 / ARQUITECTURA DE AGENTES
Un sistema de agentes con responsabilidades que no se confunden.
La autonomía no nace de añadir nombres a una lista. Nace de separar investigación, control editorial, cierre y continuidad, y de exigir una salida verificable a cada pieza.
Gateway
Telegram y CLI reciben, validan y notifican.
Intake
Tema, años, campo, criterios y rango de N.
Clasificador
Activa el contrato metodológico adecuado.
Orquestador
Ordena fases, comprueba estado y decide el siguiente paso.
Búsqueda
Consulta fuentes, normaliza registros y conserva la estrategia.
DOI y corpus
Deduplica, audita faltantes y fija el universo elegible.
Lector PDF
Poppler, Docling y OCR reconstruyen el texto completo.
Extractor
Convierte método, resultados y límites en evidencia anclada.
Sintetizador
Compara patrones, contradicciones, vacíos y tesis.
Laboratorio visual
Selecciona tablas y figuras por función analítica.
Revisión independiente
Emite dictámenes separados antes de reconciliarlos.
Auditor
Comprueba citas, coherencia, artefactos y trazabilidad.
Publication gate
Bloquea si falta evidencia, revisión o entregable.
Empaquetador
Compila MD, LaTeX, PDF, CSV, figuras y ZIP.
Persistencia
Sincroniza workspace, biblioteca y Obsidian.
Watchdog
Detecta una fase incompleta, relee y reanuda.
protocol/
records/
fulltext/
extraction/
paper/
audit/
runtime-state.json
El orquestador escribe estado. El watchdog lo relee. Los revisores no comparten dictamen. El gate solo cierra cuando existen pruebas materiales.
05 / MEMORIA MATERIAL
Se reinicia el contenedor, no la investigación.
El estado no vive en el chat. Protocolo, matrices, logs, decisiones y entregables permanecen en volúmenes compartidos. Tras un reinicio, el watchdog inspecciona lo que existe, evita confundir la raíz con una revisión y reanuda la fase pendiente.
{ "phase": "full_text", "status": "running", "next": "extraction" }
06 / ENTREGABLES
No devuelve una respuesta. Entrega un workspace científico.
Cada salida se puede abrir, corregir, recomputar o enviar sin depender del chat, del modelo que la produjo ni de una ruta privada del autor.
Manuscrito compilado
Documento final con tipografía, tablas y figuras revisadas.
LaTeX editable
Fuente completa y portable.
Manuscrito modular
Secciones corregibles por separado.
Matrices y anexos
Búsqueda, cribado, extracción y scores.
Figuras científicas
Solo visuales con función analítica.
Revisión y gate
Dictámenes, bloqueos y estado PASS.
Paquete editorial
Todo lo necesario para compartir y editar.
07 / CONTRATO DEL PRODUCTO
No tienes que confiar en Hermes. Puedes inspeccionar lo que hizo.
El smoke test valida que una revisión nazca y deje artefactos. Clean-room comprueba que el bundle se instala desde cero. El publication gate demuestra qué se buscó, qué se excluyó, qué se leyó y por qué la revisión cerró o quedó bloqueada.
Protocolo previo al corpus
VERIFICABLEDecisiones por estudio
RECOMPUTABLEEvidencia ligada al PDF
TRAZABLERevisión editorial separada
AUDITABLECierre condicionado a artefactos
BLOQUEABLEAutomatiza la operación. La autoridad científica sigue siendo humana.
El producto reduce trabajo mecánico, pérdida de contexto y decisiones invisibles. No sustituye el juicio científico, no convierte correlación en causalidad ni garantiza aceptación editorial. Su obligación es conservar la incertidumbre, hacer visibles los límites y bloquear un cierre que no pueda sostener.