novanoticia/cie11-formulacion-clinica
v1.6.0CC-BY-4.0
Apoya a clínicos (psiquiatría, psicología clínica) a estructurar la formulación de casos ya entrevistados, con la CIE-11 como referencia diagnóstica primaria. Seis modos (completo, diferenciales, lagunas, riesgo, auditoria, auditoria-lagunas). No para autodiagnóstico ni con datos identificables de pacientes reales.
CHANGELOG
Todos los cambios notables de este proyecto se documentan en este archivo.
El formato sigue Keep a Changelog y el proyecto se adhiere a Semantic Versioning.
[1.6.0] — 2026-08-07
Cambio de empaquetado. No toca el contenido clínico: ni el SKILL.md, ni el flujo de seis pasos, ni la plantilla, ni las capas condicionales, ni las salvaguardas. Solo cambia dónde viven los archivos y cómo se instala.
Corregido
- El paquete de
dist/estaba roto y no se había detectado. Dos defectos a la vez: contenía el frontmatter anterior a la v1.5.3, conauthor,homepageyrepositoryal nivel superior, claves que el conjunto cerrado de Agent Skills no permite y que hacen fallar la subida con error duro en ChatGPT, claude.ai y la Skills API; y los archivos iban planos en la raíz del zip, sin la carpeta contenedora que el estándar exige y que ChatGPT rechaza. El arreglo del frontmatter llegó al árbol pero nadie regeneródist/, así que el paquete descargable seguía sin poder instalarse.
Añadido
- El repositorio es ahora un plugin conforme a Agent Plugins 1.0.0, el formato portátil de la Agentic AI Foundation. Se añaden
plugin.json(portable, con el$schemacanónico),.claude-plugin/plugin.json(Claude Code) y.claude-plugin/marketplace.json, que es el que permite instalarlo con/plugin marketplace add— sin él, ese comando falla con «Este repositorio no es un marketplace». - Opción 2 de instalación: ChatGPT. Se documenta el flujo completo, incluidos sus requisitos de forma y el plan necesario.
- Opción 6: instalación como plugin en Claude Code y Cowork, con la tabla de invocación con
/. scripts/build-dist.sh: el paquete se armaba a mano, que es exactamente por lo que llevaba meses desactualizado. Ahora se regenera con un script y el.skillqueda como copia byte a byte del.zip.
Cambiado
- El skill pasa de la raíz a
skills/cie11-formulacion-clinica/, junto conflujo.mdyplantilla-caso.md: es la ubicación fija que el §6.1 de la spec exige para descubrir skills. Los acompañantes quedan planos al lado delSKILL.md, no bajoreferences/, porque el cuerpo los referencia por nombre pelado. - Enlaces y árbol del repositorio en el README actualizados a la ruta nueva.
[1.5.2] — 2026-05-31
Añadido
- Compatibilidad con Mistral AI (Skills): documentada como Opción 3 de instalación en el README (descomprimir el paquete y seleccionar la carpeta en el espacio Work). La frase de apertura incluye Mistral.
Cambiado
descriptiondelSKILL.mdreescrita y reducida a menos de 500 caracteres (479) para cumplir el límite de Mistral, conservando el trigger principal, los modos y los límites de seguridad (no autodiagnóstico, no datos identificables). Paquetedist/regenerado en consecuencia.
[1.5.1] — 2026-05-31
Corregido
- Frontmatter YAML del
SKILL.md: el campodescriptionpasa a bloque escalar (>-) para evitar el error «mapping values are not allowed in this context» en parsers estrictos (p. ej. el de Perplexity). El texto de la descripción y los triggers de activación no cambian. - Paquete de
dist/(.zipy.skill) regenerado con elSKILL.mdcorregido; la versión anterior embebía el descriptor que fallaba al instalar.
Añadido
- README: Perplexity (Skills) documentado como Opción 2 de instalación; la frase de apertura deja de limitar el skill a Claude.
[1.5] — 2026-05-08
Añadido
- División del modo
auditoriaen dos modos diferenciados:auditoria: paso 1 + paso 6 + bloque A (detección de errores específicos en una formulación ya hecha).auditoria-lagunas: paso 1 + bloque B (lagunas críticas para sostener una formulación ya hecha).
- Sugerencia cruzada entre ambos modos al final de cada salida.
- Autoría explícita en frontmatter YAML del
SKILL.mdy en cabecera deflujo.md(Pablo, mindandhealth.org, github.com/novanoticia). - Archivo
LICENSEcon texto íntegro de CC BY 4.0 y atribución sugerida. - Guía profesional en PDF (22 páginas): filosofía de diseño, marco ético-legal, arquitectura, los seis pasos del flujo, modos de invocación, capas condicionales, limitaciones conocidas y sesgos identificados.
- Estructura de repositorio con subdirectorios
dist/ydocs/. - README.md con instalación detallada (Claude.ai, Claude Code, otras IAs).
Cambiado
- Licencia de CC BY-NC-SA 4.0 a CC BY 4.0 (más permisiva, máxima difusión, uso comercial permitido manteniendo atribución).
[1.4] — Iteración interna
Añadido
- Cabecera explícita ⚠ antes del paso 1 cuando se activa la capa de comorbilidad sistémica (sustituye al formato anterior con corchetes embebidos).
- Regla anti-redundancia entre pasos 2 y 3: cuando una hipótesis principal coincide con una sospecha del diferencial, no se duplica el desarrollo.
- Estructura "1 ángulo obligatorio + 1-2 a elección" en el paso 6 cuando la capa transversal de comorbilidad está activa.
- Salida pre-pseudonimización en Puerta 1: cuando se detecta identificador indirecto, el flujo ofrece una versión generalizada para confirmación, no solo lista de cambios.
- Regla estructural reforzada para Puerta 1: localidad concreta + cargo único + dato familiar específico = identificación automática, independientemente del reconocimiento del topónimo.
- Bloque de auditoría ampliado en modo
auditoria: detección de errores específicos (descartes prematuros, diferenciales no considerados, descartes orgánicos insuficientes, supuestos no fundamentados, saltos lógicos) y mini-bloque de lagunas críticas.
[1.3]
Añadido
- Detección de identificadores indirectos (combinaciones que en conjunto identifican).
- Variantes de entrada: caso ya estructurado (Tipo A), prosa narrativa (Tipo B), notas en bruto o transcripción (Tipo C).
- Capa transversal de comorbilidad sistémica (oncológico, embarazo/posparto, dolor crónico, neurológico, endocrinopatías complejas, VIH/hepatitis, inmunodepresión, insuficiencia orgánica, cardiopatía con limitación funcional, enfermedad inflamatoria sistémica).
- Versiones alternativas opcionales tras la salida principal: condensada para historia clínica y sintética para supervisión.
[1.2]
Añadido
- Modos de invocación con salvaguarda de seguridad clínica: si el caso muestra señales de riesgo agudo aunque el modo no incluya el paso 5, el flujo lo ejecuta de todos modos.
- Modos
completo(default),diferenciales,lagunas,riesgo,auditoria. - Apéndice canónico en
flujo.mdcon un caso resuelto de referencia para guiar la imitación de estilo y nivel de concisión.
[1.1]
Cambiado
- Referencia diagnóstica primaria pasa de DSM-5-TR a CIE-11 (Organización Mundial de la Salud). DSM-5-TR queda como referencia secundaria invocable solo cuando difiere de forma clínicamente relevante.
Añadido
- Especificadores integrados en hipótesis principales (curso, gravedad, características asociadas).
- Plan de exploración priorizado en el paso 4 (próxima cita / pruebas complementarias / fuentes externas, con urgencia relativa).
[1.0]
Añadido
- Primer borrador funcional con seis pasos: caso estructurado, hipótesis a considerar, diagnóstico diferencial obligatorio, lagunas, señales de riesgo, cuestionamiento epistémico.
- Dos puertas de entrada: pseudonimización y mediación clínica.
- Reglas duras transversales: no diagnóstico, no transcripción de criterios, no propuesta de tratamiento, "no documentado ≠ ausente".
- Formato de salida fijo con encabezados numerados y nota final obligatoria.