Hermes Legal

Un copiloto jurídico local para firmas, gobierno y equipos legales.

En muchos despachos y oficinas públicas, la inteligencia artificial llega como una gran promesa, pero con una pregunta incómoda de fondo: «¿Con qué fuentes está respondiendo?«. Para un equipo legal, esa pregunta no es decorativa. Es el centro del riesgo profesional.

Hermes Legal nace precisamente ahí: no como un chatbot genérico, sino como un entorno de trabajo jurídico local, conectado a un corpus normativo costarricense en Activos/Datos, con flujos de investigación, revisión de citas, memorandos, cumplimiento, contratos, litigio, tributario, laboral y gestión de asuntos. El repositorio combina un pipeline de datos legales con una inteligencia operativa de Hermes Legal Agent mediante skills, plugins, agentes, hooks y comandos que convierten el corpus en una superficie de trabajo diaria.

El público natural de este proyecto son firmas legales, departamentos jurídicos, instituciones públicas, consultorías regulatorias, equipos de legal ops y abogados que quieren usar IA sin perder el control de la fuente, la trazabilidad y el criterio profesional.

La idea central

Hermes Legal trata el derecho como una práctica de fuentes, no como una conversación improvisada. Su regla base está escrita en SOUL.md: toda afirmación jurídica sustantiva debe citar una fuente local o marcarse como pendiente de verificación.

En términos prácticos, el sistema distingue entre:

• data/output/derecho_N/article_N:
  Fuente normativa primaria limpia.
• data/case/**/unique-case.md:
  Hechos, escenarios, memorandos, cálculos y análisis internos de asuntos.
• data/raw/:
  raw cache técnico, no son autoridad legal.
• data/dataset/:
  Datos derivados o sintéticos, no son autoridad legal frente a cliente.

Esa separación es clave. Un abogado no necesita que la IA «suene segura»; necesita que muestre de dónde sale cada afirmación y dónde termina el soporte disponible.

Qué contiene el Corpus

El Corpus tiene dos capas principales.

La primera es el pipeline legal: una aplicación que extrae el texto completo de 32 ramas del derecho costarricense desde Fuentes Normativas, maneja paginación, cache, limpieza, normalización a Activos/Datos y partición por artículo. El índice actual reporta 32 de 32 ramas procesadas y más de 9.000 Activos/Datos de artículos, introducciones y cierres.

La segunda es una capa que sirve para encauzar a Hermes Legal y poder guiarlo en halucinar menos, también a buscar un «harness» que permita ser más determinístico es su resultados, esto funciona como ambiente de ejecución del Hermes Legal. Ahí viven las reglas de comportamiento, los comandos, bundles, skills, plugins, agentes programables y hooks de control.

Para una firma o institución, esto significa que la IA no empieza desde internet abierto ni desde memoria general. Empieza desde una biblioteca local, versionable, auditable y alineada con las reglas del equipo.

Del pipeline al trabajo jurídico

Hermes Legal tiene varias superficies de uso. Cada una responde a un momento distinto del trabajo legal.

1. Pipeline UI: control del corpus

La pantalla de la vista de operaciones del pipeline permite ejecutar jobs como extract_all_branches, chunk_articles, process_synthetic_article, build_dataset_jsonl y build_all_datasets. Para equipos con operaciones legales o tecnología institucional, esta pantalla importa porque convierte la actualización del corpus en un proceso reproducible.

Desde ahí se puede observar el asset graph: descarga de raw cache, extracción Activos/Datos, generación de índice, chunks por artículo y datasets derivados. El pipeline maneja detalles poco visibles pero importantes, como reintentos, rate limiting, detección de stubs del Fuentes Normativas y paginación de documentos largos.

2. Chat embebido y TUI: Hermes como mesa de trabajo

La vista /chat puede mostrar una experiencia tipo terminal embebida. Es útil para equipos que prefieren slash commands, sesiones largas y un flujo más directo. Por ejemplo, el usuario carga /legal-tax y pide un ejemplo didáctico de declaración y pago de impuestos para una persona trabajadora independiente, con la instrucción de organizar por rubros y no calcular montos si faltan datos o fuente completa.

Ese detalle revela mucho del diseño: Hermes Legal no intenta dar una respuesta fiscal definitiva sin datos. Primero estructura, pide faltantes, separa rubros y marca pendientes de verificación.

3. Plugin Help: manual vivo dentro del dashboard

El plugin plugins/help/dashboard/ agrega una pestaña de ayuda al dashboard. Su manifiesto lo describe como una «guía completa para la firma legal costarricense». No es una página de marketing: es documentación operativa incrustada en la herramienta.

Incluye ejemplos de:

• investigación jurídica inicial
• verificación de citas
• memorandos
• revisión contractual
• litigio
• laboral
• administrativo y municipal
• notarial y registral
• tributario
• privacidad y firma digital
• due diligence
• reportes de estado
• uso de agentes

Para adopción interna, esto es valioso: el abogado no tiene que recordar todos los comandos. El manual vive dentro de la misma pantalla donde trabaja.

La casa operativa del asistente

Es donde la solución deja de ser solo un pipeline y se vuelve un producto legal operativo.

Skills: flujos jurídicos especializados

Las skills son el corazón funcional. Viven en skills/legal/<skill-name>/SKILL.md y cubren tareas concretas:

• hermes-legal-core: regla base de fuentes y postura profesional.
• hermes-legal-citation-check: auditoría de afirmaciones y citas.
• hermes-legal-memo: memorandos jurídicos.
• hermes-legal-contract-review: revisión contractual.
• hermes-legal-litigation-*: intake, brief, cronología y matriz de pretensiones.
• hermes-legal-labor-qa y hermes-legal-termination-review: flujos laborales.
• hermes-legal-tax-qa: consultas tributarias.
• hermes-legal-admin-procedure-check: administrativo, regulatorio y municipal.
• hermes-legal-notarial-review y hermes-legal-registral-check: trabajo notarial y registral.
• hermes-legal-data-privacy-triage y hermes-legal-digital-signature-review: privacidad, tecnología y firma digital.
• hermes-legal-corpus-health-check: salud del corpus.

La ventaja para una firma es que cada skill encapsula una forma de trabajar, no solo una instrucción suelta. Un memorando pide hechos, cuestión, respuesta breve, norma aplicable, análisis, riesgos, fuentes y pendientes. Una revisión contractual separa riesgo legal, riesgo comercial y redacción sugerida. Una consulta tributaria evita calcular si faltan datos o fuente.

Skill bundles y slash commands

Los bundles en skill-bundles/*.yaml convierten grupos de skills en comandos concretos. En el TUI, los comandos reales usan guiones:

/legal
/legal-memo
/legal-contract-review
/legal-litigation
/legal-labor
/legal-tax
/legal-admin
/legal-notarial-registral
/legal-privacy
/legal-diligence
/legal-compliance
/legal-corpus-health

Esto ayuda a operar por contexto. Si el asunto es laboral, /legal-labor carga core, citation check, labor QA y termination review. Si el asunto es tributario, /legal-tax carga core, citation check y tax QA.

Commands: mapa documental de workflows

commands/legal documenta equivalencias y convenciones. Distingue comandos reales del runtime con guiones, como /legal-memo.

Esa diferencia parece menor, pero evita fricción en adopción. En un equipo grande, la documentación debe decir no solo qué hacer, sino qué hacer cuando un comando no aparece.

Plugins

Hay dos plugins relevantes:

• plugins/help/: dashboard de ayuda para usuarios legales.
• plugins/hermes-legal/: esqueleto del plugin local, con plugin.yaml, schemas.py y tools.py.

El plugin hermes-legal expone hoy rutas del corpus (data/output y data/case) y reserva el lugar para herramientas futuras. En el estado actual del repo, las skills son la superficie legal principal. Esto es una decisión razonable: primero se estabiliza el modo de trabajo; luego se automatizan herramientas más específicas.

Agents: vigilancia y gestión recurrente

Los agentes en agents/*.md son workflows programables o ejecutables manualmente:

• reform-watch.md: vigilancia semanal de cambios normativos.
• corpus-health-check.md: auditoría diaria o post-extracción del corpus.
• deadline-watch.md: alertas de plazos, con regla crítica de no calcular sin fecha base, norma y calendario revisado.
• renewal-watch.md: vencimientos y renovaciones contractuales.
• client-status-weekly.md: reportes semanales para cliente, equipo interno y socio/director.

Estos agentes apuntan a una visión madura de legal ops: la IA no solo responde preguntas; también ayuda a monitorear riesgos repetitivos.

Hooks

Los controles existentes están en agent-hooks/:

• legal-source-guard.sh: rechaza data/raw/ y data/dataset/ como autoridad legal.
• output-review-gate.sh: agrega una advertencia si una respuesta parece contener afirmaciones jurídicas sin citar data/output/... o data/case/....

Para un despacho, estos hooks son una forma concreta de gobernanza. No dependen solo de «buenas instrucciones»; ponen barandas alrededor del agente.

Un flujo típico en una firma legal

Imaginemos un cliente empresarial que pregunta si puede terminar un contrato de servicios, despedir a una persona trabajadora o presentar una gestión municipal urgente.

El flujo sano no es pedir «dame la respuesta». El flujo sano es:

El resultado no sustituye al abogado. Lo vuelve más rápido y más ordenado. El socio recibe un borrador con fuentes, supuestos y pendientes; no una caja negra.

Análisis normativo

En gobierno, la trazabilidad pesa tanto como la velocidad. Una institución que adopta IA para análisis normativo necesita saber:

• qué corpus usó
• cuándo se actualizó
• qué ramas cubre
• que afirmaciones tienen fuente
• qué quedó pendiente de verificación
• qué no debe citarse como autoridad

Hermes Legal responde a esa necesidad con estructura local. El pipeline produce un corpus inspeccionable. SOUL.md define reglas. Los hooks advierten desviaciones. Los agentes pueden auditar salud del corpus o cambios normativos. Los reportes pueden guardarse como Activos/Datos para revisión institucional.

Por qué importa:

«para firmas y servicios legales».

Para una firma, Hermes Legal puede operar como un asociado junior extremadamente disciplinado si se le usa bien:

• mapea ramas jurídicas antes de concluir
• lee artículos concretos
• prepara memorandos con fuentes
• revisa contratos por riesgo y redacción
• arma cronologías y claim charts
• estructura due diligence
• audita citas antes de enviar
• produce reportes de estado por audiencia
• marca lo desconocido como pendiente

La palabra clave es «disciplinado». La herramienta está diseñada para no premiar la respuesta rápida sin soporte.

El caso tributario:

«Un buen ejemplo de comportamiento seguro».

El flujo /legal-tax ilustra bien el carácter del proyecto. La pregunta puede sonar simple: preparar un ejemplo de declaración y pago de impuestos para una persona trabajadora independiente. Pero una respuesta responsable no debe inventar tarifas, porcentajes, formularios ni saldos.

Hermes Legal pide organizar por rubros:

• actividad registrada
• ingresos gravados
• IVA débito
• IVA crédito
• gastos deducibles o deducción presunta
• renta neta
• cuotas de CCSS independiente
• retenciones
• pagos parciales
• saldo y forma de pago
• fuentes locales y fuentes web secundarias
• pendientes ante Hacienda, ATV, DGT o reglamento aplicable

También permite ejemplos por actividad: abogado, contador, consultor, profesional de salud, desarrollador, creativo digital, técnico o capacitador. La utilidad no está en fingir precisión; está en convertir una consulta borrosa en una lista verificable de datos, rubros y riesgos.

La promesa real

Hermes Legal no promete reemplazar el juicio profesional. Promete algo más útil: poner una capa de IA encima de fuentes locales, reglas claras y flujos jurídicos repetibles.

Para una firma, eso puede significar menos tiempo perdido buscando el artículo correcto y más tiempo pensando estrategia. Para una institución pública, puede significar mejores controles de trazabilidad. Para un abogado independiente, puede significar una mesa de trabajo que ayuda a estructurar, revisar y documentar.

La IA jurídica que vale la pena no es la que habla más bonito. Es la que sabe decir:

Fuente encontrada.
Fuente no encontrada.
Pendiente de verificación.
Supuesto usado.
Revisión profesional requerida.

Modelos: local vs. cloud

Cómo alternar entre Qwopus y DeepSeek

Hermes Legal puede ejecutarse con dos backends de inferencia distintos, según las necesidades del equipo:

Backend	Proveedor	Modelo	Cuándo usarlo
Local	llama-server	Qwopus3.6-27B-v2-MTP-Q4_K_M	Privacidad total, sin conexión, sin costo por token
Cloud	OpenRouter	deepseek/deepseek-v4-pro	Mayor capacidad, razonamiento complejo, acceso desde cualquier máquina

Hermes Legal está construido alrededor de esa diferencia.