La mayoría de las personas que descubren Hermes Agent pasan la primera semana confundidas.
No porque Hermes sea complicado.
Porque nadie ha escrito la guía completa que te lleve desde cero conocimiento hasta un sistema de agente autónomo totalmente operativo de una sola vez.
Esta es esa guía.
Al final de esta masterclass habrás instalado Hermes, configurado tu primer agente, creado tu primera habilidad, conectado tu primer servidor MCP, configurado la memoria persistente, automatizado tu primer flujo de trabajo y desplegado una operación multiagente que funciona sin ti.
Cada sección se basa en la anterior. Léela en orden la primera vez. Vuelve a secciones específicas cuando necesites consultarlas después.
Sección 1: Qué es realmente Hermes Agent
Antes de instalar nada, entiende con qué estás construyendo.
Hermes Agent es un framework de agente de IA autónomo de código abierto. No es un chatbot. No es un envoltorio alrededor de una herramienta existente. Es una infraestructura para construir agentes que operan de forma persistente, recuerdan todo a través de las sesiones, ejecutan flujos de trabajo reutilizables y se ejecutan autónomamente en un horario.
Las cuatro propiedades que hacen a Hermes diferente de cualquier otro framework de agente:
Memoria persistente. La mayoría de los agentes de IA lo olvidan todo cuando cierras la sesión. Hermes recuerda. Cada conversación, cada tarea, cada salida, cada decisión se almacena en una capa de memoria que persiste indefinidamente. El agente con el que interactúas hoy sabe todo lo que sucedió en cada sesión anterior.
Sistema de habilidades. Hermes ejecuta archivos de flujo de trabajo reutilizables llamados habilidades. Escribes una habilidad una vez como un archivo Markdown plano que describe lo que el agente debe hacer. Cada ejecución posterior llama a esa habilidad sin reconstruir la lógica. Tu operación se vuelve más rápida y consistente con cada habilidad que agregas.
Automatización programada. Hermes se ejecuta en un horario configurable sin que tú inicies nada. Informes matutinos de investigación. Procesamiento de contenido nocturno. Monitoreo de fuentes por hora. Todo se activa automáticamente en los horarios que configures.
Integración MCP. Hermes se conecta a servidores del Protocolo de Contexto de Modelo que le dan acceso a herramientas reales. Sistemas de archivos. Bases de datos. Búsqueda web. APIs. Servicios externos. Cada conexión MCP transforma a Hermes de un modelo de lenguaje a un agente que actúa en el mundo real.
Estas cuatro propiedades juntas producen algo cualitativamente diferente de cualquier interacción individual con IA.
Un agente Hermes no es una herramienta que usas.
Es un sistema que opera.
Sección 2: Instalación y configuración inicial
Requisitos previos:
Node.js versión 18 o superior. Git. Una terminal que te resulte cómoda usar.
Verifica tu versión de Node.js:
node --version
Si necesitas instalar o actualizar Node.js, visita nodejs.org y descarga la versión LTS actual.
Instalar Hermes:
git clone https://github.com/hermes-agent/hermes
cd hermes
npm install
Configurar tu entorno:
cp .env.example .env
Abre el archivo .env y configura tu proveedor de modelo:
Configuración del modelo principal
MODEL_PROVIDER=anthropic
MODEL_NAME=claude-opus-4-5
ANTHROPIC_API_KEY=tu-clave-api-de-anthropic
Alternativa: Usar DeepSeek para operación gratuita
MODEL_PROVIDER=deepseek
MODEL_NAME=deepseek-chat
DEEPSEEK_API_KEY=tu-clave-deepseek
Configuración de memoria
MEMORY_BACKEND=sqlite
MEMORY_PATH=./data/memory.db
Programador
ENABLE_SCHEDULER=true
SCHEDULER_TIMEZONE=America/New_York
Registro (logging)
LOG_LEVEL=info
LOG_PATH=./logs/hermes.log
Iniciar Hermes:
npm run start
Deberías ver una salida que confirme que Hermes está funcionando:
[Hermes] Backend de memoria: SQLite inicializado
[Hermes] Directorio de habilidades: ./skills cargado
[Hermes] Programador: habilitado
[Hermes] Agente listo. Esperando instrucciones.
Hermes ahora se está ejecutando con memoria persistente y el programador activo.
Verificar la instalación:
Escribe tu primer mensaje:
Hola. ¿Qué sabes de ti mismo?
Hermes debería responder describiendo su configuración, estado de memoria y habilidades disponibles.
Sección 3: Comprender la arquitectura de archivos
Antes de construir nada, entiende dónde vive todo.
hermes/
skills/
[tu-nombre-de-habilidad].md
data/
memory.db
processed/
outputs/
logs/
hermes.log
config/
sources.json
schedule.json
CLAUDE.md
.env
package.json
skills/ es donde vive cada flujo de trabajo que construyes. Cada habilidad es un archivo Markdown. Hermes lee estos archivos y ejecuta los flujos de trabajo que describen.
data/ es donde Hermes almacena todo lo que procesa. memory.db es la base de datos SQLite que impulsa la memoria persistente. processed/ contiene elementos que han sido manejados. outputs/ contiene contenido generado.
logs/ contiene los registros de operación. Revisa hermes.log cuando algo no funcione como se espera.
config/ contiene tus archivos de configuración. sources.json define tus fuentes de contenido. schedule.json define cuándo se ejecutan los flujos de trabajo automatizados.
CLAUDE.md es el archivo más importante de toda la instalación. Le dice a Hermes todo sobre quién eres, qué haces y cómo quieres que opere. Lo construimos en la Sección 4.
Sección 4: Escribir tu CLAUDE.md
El CLAUDE.md es la constitución operativa de tu agente Hermes.
Cada habilidad lo lee antes de ejecutarse. Cada flujo de trabajo automatizado lo utiliza como contexto. Cada salida se moldea a partir de él.
Un CLAUDE.md mal escrito produce salidas genéricas.
Un CLAUDE.md escrito con precisión produce salidas que parecen hechas por alguien que conoce tu operación al dedillo.
Aquí está la plantilla completa:
Hermes Agent — CLAUDE.md
Identidad
Nombre: [TU NOMBRE O MARCA]
Rol: [LO QUE HACES]
Plataforma principal: [DÓNDE PUBLICAS]
Audiencia: [A QUIÉN SIRVES]
Enfoque de contenido y trabajo
Temas principales: [LISTA TUS TEMAS PRINCIPALES]
Formatos de contenido: [LO QUE CREAS]
Voz y tono: [CÓMO TE COMUNICAS]
Lo que nunca haces: [COSAS ESPECÍFICAS QUE EVITAR]
Proyectos actuales
[PROYECTO 1]: [DESCRIPCIÓN DE UNA ORACIÓN]
Estado: [ACTIVO/PENDIENTE/COMPLETADO]
Próxima acción: [PRÓXIMO PASO ESPECÍFICO]
[PROYECTO 2]: [DESCRIPCIÓN DE UNA ORACIÓN]
Estado: [ACTIVO/PENDIENTE/COMPLETADO]
Próxima acción: [PRÓXIMO PASO ESPECÍFICO]
Prioridades actuales
- [LO MÁS IMPORTANTE AHORA MISMO]
- [SEGUNDO MÁS IMPORTANTE]
- [TERCERO MÁS IMPORTANTE]
Estándares de contenido
Una gran salida: [DESCRIPCIÓN ESPECÍFICA]
Una salida aceptable: [UMBRAL MÍNIMO]
Una salida rechazada: [LO QUE FALLA]
Fuentes en las que confío
[LISTA PUBLICACIONES, CANALES, PERSONAS ESPECÍFICOS]
Lo que específicamente no quiero
[LISTA TEMAS, FORMATOS O ENFOQUES QUE EVITAR]
Reglas de memoria
- Almacena cada decisión significativa con su razonamiento
- Rastrea todo el contenido publicado con notas de rendimiento
- Recuerda las evaluaciones de calidad de las fuentes
- Nunca repitas contenido de la misma fuente en un plazo de 72 horas
Reglas de salida
- Guarda todo el contenido generado en data/outputs/
- Marca cada archivo con la fecha: AAAA-MM-DD-[tipo]-[tema].md
- Registra todas las operaciones en logs/hermes.log
- Señala cualquier cosa que requiera revisión humana antes de publicar
Programa de actualización
Revisa y actualiza este archivo: [TU PROGRAMA]
Dedica 30 minutos a completar esto completamente antes de construir cualquier habilidad. Todo lo que viene después depende de la calidad de este documento.
Sección 5: Construir tu primera habilidad
Una habilidad es un archivo Markdown de texto plano que describe un flujo de trabajo que Hermes ejecuta.
El formato de habilidad tiene cuatro secciones requeridas:
nombre-de-la-habilidad
Propósito
[Una oración que describa lo que hace esta habilidad]
Activación
[Cómo invocarla — manualmente o en un horario]
Proceso
[Instrucciones paso a paso de lo que hace Hermes]
Salida
[Lo que produce la habilidad y dónde lo guarda]
Construyamos tu primera habilidad real: un informe matutino que lea tus fuentes configuradas y entregue un resumen estructurado.
Crea skills/morning-briefing.md:
morning-briefing
Propósito
Generar un informe de inteligencia matutino estructurado
a partir de todas las fuentes configuradas y guardarlo en
la carpeta de salidas.
Activación
Programado diariamente a las 6:00 AM.
Manual: "Ejecutar informe matutino" o "Generar mi informe"
Proceso
- Leer el CLAUDE.md para obtener contexto completo sobre quién soy y qué temas me importan.
- Leer config/sources.json para todas las fuentes configuradas.
- Para cada fuente en mi lista de temas principales: Buscar desarrollos significativos de las últimas 24 horas utilizando búsqueda web.
Filtrar los resultados usando estos criterios:
INCLUIR: Nuevos anuncios, actualizaciones importantes,
hallazgos de investigación, movimientos estratégicos de actores clave
EXCLUIR: Contenido reciclado, artículos de opinión sin
información nueva, cualquier cosa que clasificaría como ruido
según mis preferencias en CLAUDE.md
- Revisar la memoria en busca de cualquier cosa relevante de sesiones anteriores que se conecte con las noticias de hoy.
- Generar el informe en este formato:
Informe Matutino — [FECHA]
LA ÚNICA COSA
[El desarrollo más importante de hoy y por qué
importa específicamente para mi trabajo]
LO QUE SUCEDIÓ
[3-7 elementos significativos, cada uno de 2-3 oraciones]
QUÉ VIGILAR
[1-2 situaciones en desarrollo que vale la pena monitorear]
DESDE LA MEMORIA
[Cualquier conexión relevante con algo almacenado
en sesiones anteriores]
ENFOQUE DE HOY
[Una prioridad recomendada basada en el informe]
- Guardar el informe en: data/outputs/[FECHA]-morning-briefing.md
- Almacenar un resumen en la memoria con la etiqueta: daily-brief
Salida
Archivo de informe estructurado en la carpeta outputs.
Entrada de memoria etiquetada: daily-brief
Entrada de registro en hermes.log
Prueba tu primera habilidad:
Ejecutar informe matutino
Observa a Hermes ejecutar cada paso, buscar información y generar tu primer informe automatizado.
Sección 6: El sistema de memoria
La memoria es lo que transforma a Hermes de una herramienta capaz a un sistema que se acumula.
Entender cómo funciona la memoria te permite diseñar habilidades que se vuelven progresivamente más inteligentes con el tiempo.
Cómo Hermes almacena la memoria:
Cada operación significativa crea una entrada de memoria en la base de datos SQLite. Cada entrada tiene:
- Contenido: lo que se almacenó
- Etiquetas: categorías para recuperación
- Marca de tiempo: cuándo se creó
- Fuente: qué habilidad lo creó
- Puntuación de relevancia: se actualiza según la frecuencia con la que se recupera
Cómo Hermes recupera la memoria:
Cuando se ejecuta cualquier habilidad, Hermes busca automáticamente en la memoria el contexto relevante antes de ejecutarse. La búsqueda utiliza similitud semántica, por lo que los conceptos relacionados aparecen incluso cuando las palabras clave exactas no coinciden.
Diseñar habilidades para la memoria:
Incluye instrucciones de memoria explícitas en cada habilidad:
Instrucciones de memoria
ALMACENAR después de completar:
- Hallazgos clave etiquetados: [etiquetas-relevantes]
- Decisiones tomadas etiquetadas: decision
- Salidas producidas etiquetadas: output
RECUPERAR antes de empezar:
- Ejecuciones anteriores de esta habilidad
- Cualquier entrada etiquetada: [etiquetas-relevantes]
- Decisiones que afecten este flujo de trabajo
Operaciones manuales de memoria:
Almacena esto en la memoria: [información] — etiquétalo como [etiqueta]
¿Qué recuerdas sobre [tema]?
Muéstrame todas las entradas de memoria de los últimos 7 días
¿Qué decisiones se han almacenado?
El efecto compuesto de la memoria:
Un agente Hermes con una semana de memoria es útil.
Un agente Hermes con tres meses de memoria es una categoría diferente de herramienta.
Después de tres meses de operación diaria, Hermes ha leído cientos de fuentes, procesado miles de piezas de contenido, rastreado docenas de decisiones y construido una imagen detallada de lo que funciona y lo que no en tu operación específica.
Cada nueva tarea se beneficia de ese contexto acumulado.
Sección 7: Conectar servidores MCP
Los servidores MCP transforman a Hermes de un agente que razona sobre el mundo a un agente que actúa sobre él.
Cada conexión MCP le da a Hermes acceso a una herramienta real. Sistemas de archivos. Búsqueda web. Bases de datos. APIs. Servicios externos.
Instalar los servidores MCP principales:
Filesystem MCP — leer y escribir archivos locales
npm install -g @modelcontextprotocol/server-filesystem
Web search — Brave Search en tiempo real
npm install -g @modelcontextprotocol/server-brave-search
GitHub — acceso a repositorios
npm install -g @modelcontextprotocol/server-github
Puppeteer — automatización del navegador
npm install -g @modelcontextprotocol/server-puppeteer
Configurar las conexiones MCP en tu .env:
Filesystem
MCP_FILESYSTEM_PATH=/ruta/a/tu/directorio/de/trabajo
Brave Search
MCP_BRAVE_API_KEY=tu-clave-api-de-brave-search
GitHub
MCP_GITHUB_TOKEN=tu-token-de-acceso-personal-de-github
Puppeteer
MCP_PUPPETEER_HEADLESS=true
El MCP de Filesystem:
La conexión más valiosa de inmediato. Le da a Hermes acceso directo de lectura y escritura a tus archivos locales.
Una vez conectado, Hermes puede:
Leer archivos que especifiques en las instrucciones de la habilidad. Escribir salidas directamente en carpetas de tu sistema. Actualizar archivos basándose en nueva información. Monitorear carpetas en busca de nuevo contenido.
Habilidades que usan el MCP de Filesystem:
Proceso
- Leer el archivo en [RUTA] para contexto
- Procesar el contenido
- Escribir la salida en [RUTA DE SALIDA]
- Actualizar el archivo de índice en [RUTA DE ÍNDICE]
El MCP de Brave Search:
Le da a Hermes acceso a la búsqueda web en tiempo real. Sin esto, Hermes solo puede razonar sobre información hasta su fecha de corte de entrenamiento. Con él, Hermes busca en la web en vivo información actual.
Cada habilidad de investigación, monitoreo e informes se beneficia de Brave Search.
Obtén tu clave de API gratuita de Brave Search en brave.com/search/api. El nivel gratuito permite 2,000 consultas por mes.
El MCP de GitHub:
Le da a Hermes acceso a los repositorios de GitHub. Puede leer código, verificar repositorios en tendencia, monitorear repositorios que sigues y rastrear versiones.
Valioso para: contenido de herramientas para desarrolladores, monitoreo de código abierto, investigación técnica, análisis de repositorios.
Verificar las conexiones MCP:
¿Qué servidores MCP están conectados actualmente?
Lista todas las herramientas disponibles de los servidores conectados.
Hermes debería listar cada servidor conectado y las herramientas que cada uno proporciona.
Sección 8: El sistema de programación
El programador transforma a Hermes de una herramienta que usas a un sistema que opera.
Sin el programador: Hermes hace lo que le pides cuando se lo pides.
Con el programador: Hermes opera continuamente, estés involucrado o no.
Configurar tu horario:
Crea config/schedule.json:
{
"schedules": [
{
"skill": "morning-briefing",
"cron": "0 6 \ \ *",
"description": "Informe matutino diario a las 6 AM"
},
{
"skill": "source-monitor",
"cron": "0 \/2 \ \ \",
"description": "Revisar fuentes cada 2 horas"
},
{
"skill": "content-processor",
"cron": "0 20 \ \ *",
"description": "Procesar contenido capturado a las 8 PM"
},
{
"skill": "weekly-review",
"cron": "0 19 \ \ 0",
"description": "Revisión semanal cada domingo a las 7 PM"
},
{
"skill": "memory-consolidation",
"cron": "0 23 \ \ *",
"description": "Consolidar entradas de memoria a las 11 PM"
}
]
}
Referencia de expresiones cron:
0 6 \ \ * → 6 AM todos los días
0 \/2 \ \ \ → Cada 2 horas
0 20 \ \ 1-5 → 8 PM de lunes a viernes
0 19 \ \ 0 → 7 PM cada domingo
0 23 \ \ * → 11 PM todos los días
Los cinco flujos de trabajo programados que toda operación de Hermes necesita:
Informe matutino: 6 AM diario. Lee fuentes. Genera informe de inteligencia. Establece el enfoque del día.
Monitor de fuentes: Cada 2 horas. Revisa las fuentes configuradas en busca de nuevo contenido. Agrega a la cola de procesamiento.
Procesador de contenido: 8 PM diario. Procesa todo lo capturado durante el día. Genera salidas. Actualiza la memoria.
Revisión semanal: Domingo 7 PM. Sintetiza la actividad de la semana. Identifica patrones. Genera ideas.
Consolidación de memoria: 11 PM diario. Revisa nuevas entradas de memoria. Elimina duplicados. Actualiza puntuaciones de relevancia.
Monitorear la ejecución programada:
Muéstrame las operaciones programadas para hoy
¿Qué se ejecutó en las últimas 24 horas?
Muéstrame el registro de ejecución
Sección 9: Construir una operación de contenido completa
Esta sección te guía en la construcción de una operación de contenido automatizada completa con Hermes. Al final, tendrás un sistema que monitorea fuentes, identifica oportunidades de contenido viral, genera borradores y gestiona una cola de publicación automáticamente.
Paso 1: Configurar tus fuentes
Crea config/sources.json:
{
"sources": [
{
"name": "Blog de Anthropic",
"type": "rss",
"url": "https://anthropic.com/news/rss",
"priority": "critical",
"check_interval": "1h"
},
{
"name": "GitHub Trending AI",
"type": "web",
"url": "https://github.com/trending/python?since=daily",
"priority": "high",
"check_interval": "4h"
},
{
"name": "HackerNews IA",
"type": "web",
"url": "https://news.ycombinator.com",
"priority": "medium",
"check_interval": "2h"
}
]
}
Paso 2: Construir el identificador de oportunidades de contenido
Crea skills/content-opportunity.md:
content-opportunity
Propósito
Escanear todas las fuentes en busca de oportunidades de contenido
que valga la pena crear y agregarlas a la cola de contenido.
Activación
Se ejecuta después de que source-monitor detecte nuevo contenido.
Manual: "Encontrar oportunidades de contenido"
Proceso
- Leer el CLAUDE.md para mis pilares de contenido y audiencia.
- Leer todos los elementos marcados como nuevos por source-monitor desde la memoria etiquetados: source-monitor-new.
- Para cada nuevo elemento evaluar:
PUNTUACIÓN DE POTENCIAL VIRAL (1-10):
- ¿Es algo que le importa a mi audiencia específica?
- ¿Es información genuinamente nueva o un reciclaje?
- ¿Se conecta con alguno de mis pilares de contenido actuales?
- ¿Hay un ángulo único que pueda tomar y que otros no hayan visto?
Solo los elementos con puntuación de 7 o superior califican como oportunidades.
- Para cada oportunidad calificada, crear una entrada en data/outputs/content-queue.md con:
- Fuente y enlace
- Por qué es una oportunidad
- Ángulo de contenido sugerido
- Formato sugerido (tweet/hilo/artículo/video)
- Prioridad: urgente/alta/media
- Almacenar todas las oportunidades en la memoria etiquetadas: content-queue
Salida
Archivo content-queue.md actualizado.
Entradas de memoria etiquetadas: content-queue
Paso 3: Construir el generador de borradores
Crea skills/draft-generator.md:
draft-generator
Propósito
Generar borradores de contenido para los elementos en la
cola de contenido según su prioridad.
Activación
Se ejecuta diariamente a las 2 PM.
Manual: "Generar borradores" o "Redactar los 3 mejores elementos"
Proceso
- Leer el CLAUDE.md para mi voz, tono y reglas de contenido.
- Leer data/outputs/content-queue.md para los elementos pendientes.
- Seleccionar los 3 mejores elementos por puntuación de prioridad.
- Para cada elemento seleccionado:
a. Investigar el tema usando búsqueda web para asegurar
que la información sea actual y precisa
b. Revisar la memoria en busca de cobertura previa de
este tema para evitar repeticiones
c. Generar el borrador en el formato especificado:
Para TWEETS:
Seguir el formato cyrilXBT:
- Gancho de declaración en MAYÚSCULAS
- Líneas cortas y contundentes
- Cada oración en su propia línea
- Guarda esto + Llamada a la acción al final
Para HILOS:
- Tweet de gancho
- 5-8 tweets de cuerpo con detalles específicos
- Cierre con llamada a la acción
Para ARTÍCULOS:
- Párrafo de gancho fuerte
- Declaración del problema
- Explicación de la solución
- Pasos procesables
- Llamada a la acción para seguir
- Guardar cada borrador en: data/outputs/drafts/[FECHA]-[FORMATO]-[TEMA].md
- Actualizar content-queue.md marcando los elementos como redactados.
- Almacenar resúmenes de borradores en la memoria etiquetados: draft-generated
Salida
Archivos de borrador en data/outputs/drafts/
content-queue.md actualizado
Entradas de memoria etiquetadas: draft-generated
Paso 4: Construir el rastreador de rendimiento
Crea skills/performance-tracker.md:
performance-tracker
Propósito
Rastrear el rendimiento del contenido y usar los datos para
mejorar futuras decisiones de contenido.
Activación
Manual: "Registrar rendimiento de [contenido] — [métricas]"
La revisión semanal lee todos los registros de rendimiento.
Proceso
- Cuando se active con datos de rendimiento:
- Almacenar las métricas en la memoria con la referencia del contenido
- Etiquetar: performance-log
- Identificar patrones:
- ¿Qué temas tuvieron mejor rendimiento esta semana?
- ¿Qué formatos tuvieron mayor participación?
- ¿Qué fuentes produjeron el contenido más viral?
- Actualizar las prioridades de contenido en CLAUDE.md basándose en los datos de rendimiento si los patrones son claros.
- Generar informe de rendimiento semanal los domingos.
Salida
Entradas de memoria etiquetadas: performance-log
Informe de rendimiento semanal en la carpeta outputs
Sección 10: Operaciones multiagente
Un solo agente Hermes es potente. Hermes multiagente es una categoría diferente de capacidad.
La operación multiagente significa múltiples instancias especializadas de Hermes, cada una manejando un dominio de tu operación, compartiendo memoria y coordinando salidas.
La operación de contenido con cuatro agentes:
Agente de investigación: Monitorea fuentes, identifica oportunidades, realiza investigaciones profundas. Solo lee. Nunca crea.
Agente de producción: Toma las salidas de investigación y genera borradores de contenido. Solo crea. Nunca publica.
Agente de calidad: Revisa las salidas de producción contra los estándares. Aprueba o devuelve para revisión. Nunca crea ni publica.
Agente de distribución: Toma las salidas aprobadas y gestiona el calendario de publicación. Solo publica. Nunca crea.
Configurar la configuración multiagente:
Crea archivos CLAUDE.md separados para cada agente:
hermes-research/
CLAUDE.md ← Constitución del agente de investigación
skills/ ← Habilidades solo de investigación
hermes-production/
CLAUDE.md ← Constitución del agente de producción
skills/ ← Habilidades solo de producción
hermes-quality/
CLAUDE.md ← Constitución del agente de calidad
skills/ ← Habilidades solo de calidad
hermes-distribution/
CLAUDE.md ← Constitución del agente de distribución
skills/ ← Habilidades solo de distribución
La capa de memoria compartida:
Configura los cuatro agentes para que apunten a la misma base de datos SQLite:
MEMORY_PATH=/shared/hermes-memory.db
Esto significa que cada agente lee las salidas de todos los demás agentes. Las salidas de investigación son visibles para producción. Las salidas de producción son visibles para calidad. Las aprobaciones de calidad son visibles para distribución.
El protocolo de traspaso:
Cada agente señala que está listo para el traspaso a través de etiquetas de memoria:
El agente de investigación completa el trabajo → almacena la salida etiquetada: ready-for-production
El agente de producción recoge los elementos etiquetados → almacena la salida etiquetada: ready-for-quality
El agente de calidad aprueba → almacena la salida etiquetada: ready-for-distribution
El agente de distribución publica → almacena el resultado etiquetado: published
La habilidad del orquestador:
Crea una habilidad maestra de orquestación que monitoree todo el pipeline:
pipeline-orchestrator
Propósito
Monitorear los cuatro agentes y asegurar traspasos
suaves entre las etapas del pipeline.
Activación
Se ejecuta cada 30 minutos.
Proceso
- Verificar elementos etiquetados: ready-for-production Si se encuentran: alertar al agente de producción
- Verificar elementos etiquetados: ready-for-quality Si se encuentran: alertar al agente de calidad
- Verificar elementos etiquetados: ready-for-distribution Si se encuentran: alertar al agente de distribución
- Verificar elementos en cualquier etapa por más de 4 horas Si se encuentran: marcar como estancados y alertar para revisión
- Generar informe de estado del pipeline cada 4 horas
Salida
Estado del pipeline en la memoria etiquetado: pipeline-status
Alertas para elementos estancados
Registro de operación por hora
Sección 11: Patrones de habilidades avanzadas
A medida que tu operación de Hermes madure, te encontrarás con situaciones que el formato básico de habilidad no cubre. Estos patrones avanzados manejan los escenarios complejos más comunes.
Patrón 1: Ejecución condicional
Habilidades que toman diferentes caminos según condiciones:
Proceso
- Verificar condición: [QUÉ VERIFICAR]
- SI [CONDICIÓN A]: Ejecutar camino A: [PASOS PARA EL CAMINO A]
SI [CONDICIÓN B]:
Ejecutar camino B:
[PASOS PARA EL CAMINO B]
SI NINGUNA:
Señalar para revisión humana y registrar el caso ambiguo.
Patrón 2: Lógica de reintento
Habilidades que deben reintentar en caso de fallo:
Proceso
Para cada elemento, intentar lo siguiente hasta 3 veces:
- Intentar: [ENFOQUE PRINCIPAL] Si tiene éxito: proceder a la salida Si falla: registrar el error e intentar alternativa
- Alternativa: [ENFOQUE DE RESPALDO] Si tiene éxito: proceder a la salida con nota de que se usó la alternativa Si falla: marcar como fallido y señalar para revisión
Nunca proceder con una salida incompleta o incierta.
Patrón 3: Puertas de calidad
Habilidades que imponen estándares antes de producir resultados:
Control de calidad
Antes de guardar cualquier resultado, evalúa según estos criterios:
Criterios APROBATORIOS (todos deben cumplirse):
- [CRITERIO 1]
- [CRITERIO 2]
- [CRITERIO 3]
Si APRUEBA: guarda el resultado y registra el éxito
Si FALLA: identifica qué criterio falló, intenta la
revisión y vuelve a evaluar. Máximo 2 intentos de revisión.
Si sigue fallando tras 2 intentos: guarda en la
carpeta de pendientes-revisión/ con notas de error.
Patrón 4: Ejecución informada por la memoria
Habilidades que se vuelven más inteligentes con cada ejecución:
Proceso informado por la memoria
Antes de ejecutar, recupera:
- Todas las ejecuciones anteriores de esta habilidad desde la memoria
- Datos de rendimiento etiquetados: [etiqueta-relevante]
- Notas de patrones almacenadas de ejecuciones anteriores
Usa el contexto recuperado para:
- Evitar enfoques que fallaron antes
- Priorizar enfoques que tuvieron éxito antes
- Aplicar cualquier conocimiento de patrones a la ejecución actual
Después de ejecutar, almacena:
- Qué enfoque se usó
- Si tuvo éxito
- Cualquier patrón nuevo observado
- Etiquetado: [nombre-habilidad]-aprendizaje
Sección 12: Solución de problemas comunes
Toda operación de Hermes encuentra problemas en las primeras semanas. Estos son los problemas más comunes y cómo solucionarlos.
Problema: Hermes no ejecuta las tareas programadas
Verifica que el programador esté habilitado en tu .env:
ENABLE_SCHEDULER=true
Confirma que tus expresiones cron sean válidas usando crontab.guru.
Revisa el hermes.log para ver errores del programador:
tail -f logs/hermes.log
Problema: La memoria no persiste entre sesiones
Verifica que la ruta de la base de datos de memoria sea correcta:
MEMORY_PATH=./data/memory.db
Revisa los permisos de archivo en el directorio data:
ls -la data/
El proceso de Hermes necesita permisos de escritura en este directorio.
Problema: Los servidores MCP no se conectan
Verifica que el servidor MCP esté instalado globalmente:
which npx
npx @modelcontextprotocol/server-filesystem --help
Revisa que tus claves API estén configuradas correctamente en .env sin espacios al final.
Reinicia Hermes después de cambiar la configuración de MCP.
Problema: Los resultados de las habilidades son de baja calidad
La causa más común es un CLAUDE.md poco específico. Vuelve a la Sección 4 y añade más detalle concreto a cada sección.
También verifica que la sección de Proceso de la habilidad sea lo suficientemente específica. Las instrucciones vagas producen resultados vagos.
Problema: Hermes usa información desactualizada
Verifica que Brave Search MCP esté conectado:
¿Qué servidores MCP están conectados?
Si Brave Search no aparece, revisa tu clave API y reinstala el servidor MCP.
Problema: Las habilidades se ejecutan pero no guardan los resultados
Verifica que Filesystem MCP esté conectado y apuntando a la ruta correcta.
Revisa que las rutas de salida en tus archivos de habilidades sean relativas al directorio de trabajo donde se ejecuta Hermes.
Sección 13: Midiendo y mejorando tu operación
Una operación de Hermes que no mejora con el tiempo no está usando su sistema de memoria correctamente.
La habilidad de revisión semanal:
Crea skills/weekly-review.md:
weekly-review
Propósito
Sintetizar la operación de la semana e identificar
mejoras para la semana siguiente.
Disparador
Cada domingo a las 7 PM.
Manual: "Ejecutar revisión semanal"
Proceso
- Lee todas las entradas de memoria de los últimos 7 días.
- Analiza el rendimiento de las habilidades:
- ¿Qué habilidades se ejecutaron sin problemas?
- ¿Qué habilidades encontraron errores?
- ¿Qué habilidades produjeron los mejores resultados?
- ¿Qué habilidades necesitan mejoras?
- Analiza el rendimiento del contenido (si se registró):
- ¿Qué contenido tuvo mejor desempeño?
- ¿Qué patrones aparecen en los de alto rendimiento?
- ¿Qué temas deberían priorizarse la próxima semana?
- Analiza la calidad de la memoria:
- ¿Las entradas de memoria se están creando correctamente?
- ¿Los resultados de la recuperación son relevantes cuando se ejecutan las habilidades?
- ¿Hay lagunas en lo que se está almacenando?
- Genera recomendaciones de mejora:
- Una habilidad para mejorar esta semana
- Una nueva habilidad para construir esta semana
- Un proceso para optimizar
- Un tema para priorizar en el contenido
- Actualiza CLAUDE.md con cualquier mejora confirmada.
Resultado
Informe de revisión semanal en data/outputs/
Actualizaciones de CLAUDE.md si se identifican mejoras
Entrada de memoria etiquetada: weekly-review
Las métricas que importan:
Tasa de fiabilidad de habilidades: qué porcentaje de habilidades programadas se ejecutan sin errores. Objetivo: superior al 95%.
Relevancia de la recuperación de memoria: cuando se recupera memoria para una habilidad, ¿es realmente relevante? Revisar semanalmente.
Consistencia de la calidad de los resultados: ¿los resultados cumplen consistentemente tus estándares? Seguimiento manual.
Cobertura de la operación: qué porcentaje de tus flujos de trabajo previstos están realmente automatizados. Expandir hacia el 100% con el tiempo.
Sección 14: El plan de construcción de 90 días
Construir una operación madura de Hermes requiere 90 días de iteración constante.
Días 1 a 7: Fundación
Instala Hermes. Escribe tu CLAUDE.md. Construye la habilidad de informe matutino. Conecta los servidores MCP Filesystem y Brave Search. Ejecuta tu primer informe programado.
Objetivo: Hermes funciona de manera confiable y produce un resultado útil diariamente.
Días 8 a 30: Habilidades principales
Construye de cinco a ocho habilidades principales para tu operación específica. Configura el programador para los cinco flujos de trabajo automatizados estándar. Identifica el primer servidor MCP específico de tu dominio.
Objetivo: Hermes automatiza el 30 % de tu trabajo de conocimiento repetitivo.
Días 31 a 60: Optimización
Revisa la calidad de la memoria y mejora las convenciones de almacenamiento. Refina los resultados de las habilidades basándote en tres o cuatro semanas de resultados. Construye tus primeras habilidades avanzadas usando ejecución condicional y controles de calidad.
Objetivo: Los resultados de Hermes cumplen consistentemente los estándares de calidad sin revisión manual.
Días 61 a 90: Multiagente
Si tu operación lo justifica, diseña tu arquitectura multiagente. Construye los archivos CLAUDE.md de los agentes especialistas. Configura la capa de memoria compartida. Despliega la habilidad de orquestador.
Objetivo: Hermes ejecuta una operación multiagente coordinada que maneja tus flujos de trabajo más complejos de principio a fin.
La realidad del crecimiento compuesto
Los constructores que inician su operación Hermes hoy y la ejecutan consistentemente durante 90 días tendrán algo que no se puede replicar rápidamente.
No porque la tecnología sea difícil de acceder.
Sino porque la capa de memoria que se acumula durante 90 días de operación constante no es algo que puedas acelerar.
El agente Hermes en el día 90 conoce tu operación. Sabe qué fuentes producen el mejor contenido para tu audiencia. Sabe qué enfoques han funcionado y cuáles han fallado. Conoce tu voz, tus estándares y tus prioridades porque las ha ejecutado cientos de veces.
Esa inteligencia acumulada es la ventaja competitiva.
Cada día que ejecutas la operación, la ventaja se profundiza.
Cada día que esperas para empezar es un día de inteligencia compuesta que nunca recuperarás.
Construye la base este fin de semana.
Las habilidades se escriben en una tarde.
La memoria comienza a acumularse desde la primera sesión.
El crecimiento compuesto comienza desde el primer flujo de trabajo automatizado que se ejecuta sin ti.
Sigue a @cyrilXBT para cada construcción de Hermes Agent, plantilla de habilidad y arquitectura multiagente que hace que las operaciones autónomas de IA realmente funcionen.





