incorporar-hito

name: incorporar-hito description: Incorpora un nuevo Hito a un Caso existente a partir de un PDF de auto judicial, sentencia, informe UCO/UDEF o documento procesal equivalente. Genera borrador YAML de Hito + Documento + Hechos derivados + cambios en RolEnCaso, listo para PR. Aplica los guardarraíles del doc 03, apartado "Uso de LLM para diffs revisables". Trigger cuando el usuario pide "incorporar este auto", "añade este hito a", "procesa este PDF de Calama", o referencia un documento procesal nuevo en un caso existente.

Skill `incorporar-hito` — v1

Propósito

Tomar un documento procesal (PDF de auto, sentencia, informe UCO/UDEF, atestado, escrito de Fiscalía) y producir un borrador de PR que incorpore:

Un Documento nuevo (con su URL canónica si la hay, hash si tenemos copia).
Un Hito nuevo asociado al caso.
Los Hechos que el hito introduce o modifica, con sus documentos_respaldo.
Los cambios en RolEnCaso que el hito provoca (apertura, cierre, sucesor).

Versión v0: deliberadamente mínima. La skill se moldea con cada uso (AGENTS.md → "Skills locales").

Inputs aceptados

Ruta a un PDF en /public/documentos/ o ubicación local.
URL canónica al documento (preferido para nivel_fuente=1 si está en DominiosOficiales, doc 01 — "Enums catalogados").
Texto pegado del documento si el PDF no es procesable directamente.

Acompañado del slug del Caso destino (caso_id). Si no se proporciona, pregunta antes de actuar.

Proceso

1. Lectura del documento

Lee el documento entero. Identifica:

Órgano emisor (juzgado / tribunal / fiscalía / unidad policial).
Fecha del documento (fecha del auto, no la de publicación).
Tipo (auto, sentencia, informe, escrito de parte).
Personas y organizaciones nombradas.
Hechos nuevos sostenidos por el documento (acreditados o investigados según naturaleza del documento).
Cambios en roles procesales (imputaciones, desimputaciones, condenas).

Si el documento todavía no está descargado y necesitas localizar su PDF en una fuente oficial, consulta el catálogo técnico de portales en docs/fuentes/ (poder judicial, BOE y boletines, Fiscalía, TC, organismos económicos, legislativo, archivos y mirrors). Cada ficha trae patrones de URL estables, endpoints de búsqueda con sus parámetros reales, cobertura temporal verificada y trampas conocidas. El catálogo se amplía con cada sesión que descubre un endpoint nuevo — si encuentras uno, anótalo en la ficha correspondiente en la misma sesión.

2. Validaciones previas (bloqueantes)

Antes de proponer YAML alguno:

El Caso referenciado existe en /content/casos/<slug>/caso.yaml.
El órgano emisor existe como Organizacion en /content/organizaciones/. Si no, marca para creación.
Las personas referenciadas existen como Persona o pertenecen a la categoría "no figura pública". Si no existen, marca para creación con es_figura_publica propuesto (NUNCA false por defecto; razona).

3. Generación del borrador

Produce los YAMLs en disco bajo:

content/documentos/<slug-documento>.yaml
content/casos/<caso-id>/hitos/<slug-hito>.yaml
content/casos/<caso-id>/hechos/<slug-hecho>.yaml (uno por cada hecho derivado)
content/casos/<caso-id>/roles/<slug-rol>.yaml (uno por cada apertura o cierre)

Y abre PR con cuerpo:

Resumen: <tipo> del <fecha> incorporado al caso <slug>.
Cita del párrafo del documento que justifica cada hecho introducido (página + pasaje).
Validaciones del modelo (V-04, V-05, V-08, V-12, V-13, V-14) marcadas como verificadas o pendientes.

Proponer promoción de estado (cola para `/promover-caso`)

Tú NO cambias estado_publicacion; lo decide el rubro + panel de /promover-caso, que el maintainer autoriza. Incorporar un primario fuerte (una sentencia firme, un auto N1 que faltaba) suele ser justo lo que destraba una subida de nivel. Si tras incorporar el hito crees que el caso ya cumple para subir, déjalo propuesto en content/casos/<slug>/caso.yaml:

promocion_propuesta:
  estado_propuesto: <beta_publica|en_revision|publicado>
  propuesto_por: incorporar-hito
  fecha: "<hoy>"
  razon: "<1-3 frases MUY concisas: qué del rubro destrabó este hito>"
  estado: propuesta

Es una propuesta para la cola, no una autoevaluación: /promover-caso la verifica con su panel. estado_propuesto superior al actual; razon ≤ 400 caracteres. No la dejes si el hito abre más dudas de las que cierra. Si hay una promocion_propuesta con estado: rechazada, lee su nota_resolucion antes de reproponer.

Guardarraíles obligatorios

NUNCA asignes Hecho.tipo = acreditado automáticamente. Sólo investigado, atribuido o no_concluyente. Marcar acreditado requiere review humano explícito tras sentencia firme.
NUNCA inventes datos. Si un dato no aparece en el documento:
- Deja el campo vacío con un comentario YAML inline:
```
fecha_inicio: # LLM-incierto: el auto no precisa la fecha
```
- Reporta los campos vacíos en el cuerpo del PR para que el revisor humano los rellene.
nivel_fuente del Documento lo propones, pero CI lo valida contra V-12 (lista blanca DominiosOficiales). Niveles posibles:
- 1: oficial primaria. URL canónica en poderjudicial.es, cendoj.es, boe.es, congreso.es, senado.es, fiscal.es, tcu.es, airef.es, defensordelpueblo.es, tribunalconstitucional.es, cgpj.es, o subdominio .gob.es. Si no, baja a 2.
- 2: oficial secundaria o instructora (informe UCO/UDEF, escrito de Fiscalía publicado, nota de un órgano oficial fuera de la lista blanca).
- 3: documento de parte, institucional no jurisdiccional, pericial de parte, filtrado_verificado.
- 4: cobertura periodística. Nunca soporte único para Hecho acreditado o investigado (V-13).
No tocas enunciados publicados. Si un Hecho previo del caso queda superado, propones:
- Un Hecho nuevo tipo=exculpatorio (si el documento lo soporta) o corregido_por apuntando al nuevo.
- Marca el anterior con vigencia: superado.
- No editas el enunciado del Hecho previo.
Zonas sensibles → marca para review humano explícito:
- Cualquier persona con es_figura_publica = false que aparezca en el documento.
- Cualquier delitos_atribuidos nuevo en un RolEnCaso.
- Cualquier mención a familiares directos no formalmente investigados.
- Cualquier persona cuyo rol cierra (V-17: revisión obligatoria de anonimización).
Lenguaje (doc 04 — "Presunción de inocencia: reglas de redacción"):
- Verbos prohibidos en enunciados de hechos no acreditados: "robó", "estafó", "se apropió", "es culpable", "ha cometido".
- Verbos preferidos: "se investiga", "se atribuye", "consta en el auto X que…", "la acusación sostiene que…", "el instructor considera indiciariamente que…".
- Para sentencias no firmes: "ha sido condenado en primera instancia, pendiente de recurso".
- Si el documento contiene una afirmación tajante, cítala literal entre comillas con atribución, no la incorpores como aserción del proyecto.
Importe (si el documento cuantifica dinero). Si un Hecho derivado tiene una cifra económica clara y trazable al documento, rellena los campos importe* (doc 01 §2.6 + ficha importe-presunto):
- importe (número normalizado, sin separadores de miles), importe_alcance (total_caso / componente / individual — obligatorio si hay importe, V-22) e importe_naturaleza (perjuicio, comision_ilicita, multa_penal, responsabilidad_civil, fondo_publico_concedido, objeto_contrato, cobro_indebido, gasto_publico_cuestionado).
- Anti-doble-conteo (V-23): si la misma cifra ya está estructurada en otro Hecho del caso, o desglosa un total ya contabilizado, márcala componente (no suma) o no la estructures. Peticiones de pena no firmes y ofrecimientos no percibidos → componente. Cifras en divisa extranjera → la cifra estructurada es la relevante en euros; la divisa original va en importe_nota.
- Atribución por sujeto (importe_atribucion). Los autos y sentencias suelen desglosar quién recibe/paga/sufre el dinero: rellena entonces importe_atribucion[] con el papel económico de cada sujeto (clase objeto → activo conducta atribuida / beneficiario percibe / perjudicado víctima; clase consecuencia → obligado paga / acreedor cobra). activo ≠ percepción; el quebranto del perjudicado nunca se suma al investigado; beneficiario solo si el documento lo respalda. Cada sujeto ∈ implicados (V-24); papel coherente con la clase (V-25). Tabla en doc 01 §2.6.
- El importe hereda tipo y nivel_fuente_efectivo del Hecho. Si dudas, deja la cifra en el enunciado y marca LLM-incierto para el revisor.

Output esperado

Mensaje final al usuario:

Lista de ficheros creados o modificados.
Lista de campos LLM-incierto que requieren input humano.
Validaciones del modelo: cuáles pasan, cuáles bloquean.
Recordatorios de revisión editorial pendientes (V-08, V-14, V-17 si aplican).

Si el LLM detecta que la incorporación puede violar un principio del proyecto (AGENTS.md → "Principios irrenunciables"), se detiene y pregunta antes de tocar nada.

Iteración

Esta es la v0. Tras cada uso real (cada PDF procesado), añade aquí lecciones aprendidas como bullets en una sección "Histórico" — por ejemplo, frases del LLM que se repiten y conviene templatizar, edge cases de tipos de documento no contemplados, errores de fecha que han pasado, etc. La skill mejora con uso, no con diseño anticipado.

Histórico

Plus Ultra PR1 (2026-05-21) — bautismo de la skill

Primer uso real. Se incorpora el auto del JCI nº 4 del 19-may-2026 que cita a Zapatero como investigado. Fuente N1: nota institucional del CGPJ en poderjudicial.es (dominio en lista blanca DominiosOficiales). El auto íntegro no estaba en CENDOJ todavía; se cita por extracto institucional.

Lecciones:

acreditado excluye factuales administrativos no controvertidos. Un Real Decreto en BOE o una nota institucional sobre una decisión del Consejo de Ministros NO se puede modelar como acreditado aunque sean factualmente verificables: V-04 exige sentencia firme. Modelarlos como atribuido con el organismo emisor como actor identificado en el enunciado. Ejemplo: el préstamo SEPI 2021-03-09 se modela como atribuido con la nota SEPI N1 como respaldo.
Tensión brief vs realidad procesal en casos vivos. Cuando el brief del usuario está desactualizado respecto a la realidad procesal (un auto publicado después de redactar el brief), respetar el brief, documentar la discrepancia en NOTES.md del caso + ROADMAP.md → Decisiones pendientes, y deferir al maintainer. NO improvisar ni asumir luz verde.
Verbos del doc 04 — "Presunción de inocencia: reglas de redacción" obligatorios en todos los enunciados: "consta en el auto…", "se atribuye indiciariamente", "el instructor considera que…". Final explícito de presunción de inocencia ("rige el principio de presunción de inocencia mientras no recaiga resolución firme").

Plus Ultra PR2 (2026-05-21/22) — operación UDEF + cambio_organo

Segundo uso. Se incorporan 2 hitos sin documento procesal jurisdiccional publicado: operación UDEF del 11-dic-2025 (detenciones del presidente, CEO y un empresario) y cambio_organo del 3-mar-2026 (JI 15 Madrid → JCI 4 AN). Sólo había cobertura periodística N4 disponible; ni la nota CGPJ ni el comunicado oficial de la Policía Nacional pudieron localizarse con URL canónica.