name	metadatos
description	Especialista en validación y generación de metadatos YAML (frontmatter) para archivos markdown del proyecto SyV, garantizando coherencia con estándares

Skill: Metadata Validator

Competencia

Especialista en validación y generación de metadatos YAML (frontmatter) para archivos .md del proyecto "Subordinación y Valor", garantizando cumplimiento de estándares y coherencia.

Cuándo se Activa

Automáticamente al:

Crear o editar archivos .md en carpetas de contenido (0_proyecto/, 1_trasfondo/, 2_atlas/, 3_personajes/, 4_diegesis/, 5_aventuras/)
Ejecutar comando /check-metadata
Ejecutar comando /suggest-tags
Post-edición de archivos markdown (hook)

Expertise

Esquema de Metadatos Obligatorios

Campos SIEMPRE requeridos:

---
title: Título del documento
folder: ruta/relativa/desde/raiz
description: Breve descripción del contenido
---

Campos Opcionales pero Recomendados

Para todos los archivos:

tags:
  - tag1
  - tag2
  - tag3

Para cronología:

fecha: YYYY-MM-DD
region: Región, Subregión, Ciudad

Para personajes (IMPORTANTE):

facciones:
  - "Nombre Facción 1"
  - "Nombre Facción 2"
alerta-spoilers: "Texto de advertencia sobre información sensible"

Convenciones de Formato

Idioma: Campos en inglés, contenido en español
Formato de claves: kebab-case para valores (palabras-separadas-por-guiones)
Espaciado: SIEMPRE espacio después de dos puntos (:)
No tabs: Solo espacios para indentación
Arrays YAML: Guiones con espacios (- item)

Campos PROHIBIDOS

❌ NUNCA usar campos en español:

titulo (usar title)
carpeta (usar folder)
descripcion (usar description)
layout (no usar)
author (no usar)

Capacidades

1. Validar Metadatos Existentes

Verificar:

✅ Campos obligatorios presentes (title, folder, description)
✅ Formato YAML correcto (sintaxis, espaciado)
✅ Campos en inglés
✅ Ruta en folder es relativa y correcta
✅ Tags apropiados (existen en corpus, no demasiado genéricos)
✅ Campos específicos por tipo (personajes: facciones obligatorio)

2. Generar Metadatos Completos

Para nuevos archivos:

Analizar contenido para extraer información
Determinar tipo de archivo (personaje/facción/cronología/etc.)
Generar frontmatter completo con campos apropiados
Sugerir tags relevantes basados en contenido

3. Sugerir Tags

Buscar en corpus tags existentes que puedan aplicar:

Tags de ubicación (darsena, tuberias, cordoba, etc.)
Tags de personajes (nombre-apellido)
Tags de facciones (sia, arpistas, etc.)
Tags de conceptos (anatema-mecanico, qia, etc.)
Tags de períodos (caos, gran-guerra, actualidad-2178, etc.)
Tags de tipo (cronologia, relato, faccion, personaje, etc.)

4. Corregir Errores Comunes

Detectar y corregir:

Campos en español → Convertir a inglés
Falta de espacio después de : → Agregar espacio
Tabulaciones → Convertir a espacios
Tags duplicados → Eliminar duplicados
Campo facciones faltante en personajes → Agregar (vacío o poblado)
Ruta absoluta en folder → Convertir a relativa

Categorías de Tags

Tags de Ubicación

# Ciudades principales
darsena, cordoba, mendoza, el-paramo

# Zonas de Dársena
tuberias, barrios-del-muro, barrio-norte, microcentro
zona-centro, zona-militar, isla-oriental, fuera-del-muro

# Lugares específicos
nueva-basilica, universidad-catolica, torres-hidroponicas
crater, zona-exclusion, rio-de-la-plata

# Regiones
argentina, buenos-aires, pantano, delta

Tags de Personajes

# Formato: nombre-apellido (o apodo si es más conocido)
damian-diconte, francisco-de-la-cruz, padre-rafa
monsenor-miguel, hermana-superior-maria
paco-el-puntero, sor-sofia

Tags de Facciones

# Oficiales
sia, iglesia, iglesia-de-darsena
ejercito, armada, prefectura, fuerzas-armadas
gremio, la-union

# Proscritas/Secretas
arpistas, guardianes, guardianes-de-la-memoria
criptografos, canales-ocultos, resistencia
umbanda, cazadores-de-pesadillas, shipibo-conibo
traficantes-de-almas

Tags de Conceptos Centrales

anatema-mecanico, corpus-licitus
qia, inteligencia-artificial
fin-de-los-secretos, gran-guerra, gran-colapso
meteorito, crater
mision-s-a-n-t-a
herejia, tecnologia-prohibida

Tags de Períodos Históricos

mundo-antiguo (2020-2029)
anos-del-caos (2029-2038)
gran-guerra (2039-2047)
fin-de-los-secretos (2048-2061)
edad-oscura (2062-2160)
confederacion-temprana (2161-2177)
actualidad-2178

Tags de Tipo de Documento

cronologia, relato, carta, cronica, diario
faccion, personaje, arquetipo
atlas, mapa, tecnologia
constitucion, herejia
guia, aventura, investigacion

Restricciones

1. Campos Obligatorios

❌ NUNCA omitir title, folder, description
✅ SIEMPRE incluir estos tres campos

2. Idioma

❌ NUNCA usar campos en español
✅ SIEMPRE inglés para campos (title, folder, description)

3. Formato YAML

❌ NO usar tabulaciones
✅ Solo espacios para indentación
❌ NO omitir espacio después de :
✅ clave: valor (espacio obligatorio)

4. Campo Facciones (Personajes)

❌ NUNCA omitir campo facciones en personajes
✅ SIEMPRE presente (puede estar vacío: facciones: [])

5. Ruta Carpeta

❌ NO usar rutas absolutas
✅ SIEMPRE relativa desde raíz del proyecto
✅ Ejemplos: 3_personajes/principales, 1_trasfondo/cronologia

Workflows

Validar Archivo Existente

Leer frontmatter del archivo
Verificar campos obligatorios
Validar formato YAML (sintaxis, espaciado)
Comprobar idioma de campos (español)
Verificar campos específicos según tipo:
- Personajes: facciones presente
- Cronología: fecha y region apropiados
Validar tags (existen, no redundantes, apropiados)
Generar reporte:
- ✅ Correctos
- ⚠️ Advertencias (mejoras sugeridas)
- ❌ Errores (deben corregirse)

Generar Metadatos para Archivo Nuevo

Leer contenido del archivo
Determinar tipo (analizar ubicación y contenido):
- 3_personajes/ → personaje
- 1_trasfondo/facciones/ → facción
- 1_trasfondo/cronologia/ → cronología
- 2_atlas/ → ubicación/geografía
- 4_diegesis/ → relato/carta/crónica
Extraer información del contenido:
- Título (primer H1 o nombre archivo)
- Descripción (primer párrafo o resumen)
- Tags (conceptos clave mencionados)

Generar frontmatter completo:

---
title: [Extraído/generado]
folder: [Ruta relativa]
description: [Extraída/generada]
tags:
  - [sugerencias basadas en contenido]
# Campos específicos según tipo
---

Sugerir Tags

Leer contenido completo del archivo
Identificar menciones de:
- Ubicaciones (Dársena, Córdoba, Túberías, etc.)
- Personajes (nombres detectados)
- Facciones (SIA, Arpistas, Iglesia, etc.)
- Conceptos (Anatema, QIA, herejía, etc.)
- Años/períodos (detectar rango temporal)
Buscar tags EXISTENTES en corpus que coincidan
Ordenar por relevancia:
- Primero: Tags existentes (para mantener consistencia)
- Segundo: Nuevos tags sugeridos (solo si necesarios)
Advertir si tag parece demasiado genérico

Presentar lista con categorías:

Tags sugeridos (EXISTENTES):
- darsena
- sia
- damian-diconte

Tags nuevos (CREAR solo si necesario):
- [nuevo-concepto] (⚠️ Verificar si realmente necesario)

Ejemplos de Validación

Ejemplo 1: Frontmatter Correcto

---
title: Damián DiConte
folder: 3_personajes/principales
description: Detective veterano de la Dirección Nacional de Seguridad, cuya investigación lo traslada de Córdoba a Dársena.
tags:
  - damian-diconte
  - detective
  - cordoba
  - darsena
  - investigacion
facciones: []
---

Validación: ✅ TODO CORRECTO

Ejemplo 2: Frontmatter con Errores

---
title: Damián DiConte
folder: c:\Users\gcave\Projects\Dev\syv\3_personajes\principales
description: Detective veterano...
tags:
  - Damián
  - Detective
---

Errores detectados:

❌ Campo title (inglés) → Usar titulo
❌ Campo folder (inglés) → Usar carpeta
❌ Ruta absoluta en folder → Usar relativa: 3_personajes/principales
❌ Campo description (inglés) → Usar descripcion
❌ Tags con mayúsculas → Usar minúsculas kebab-case
❌ Campo facciones faltante (es personaje) → Agregar

Corrección:

---
title: Damián DiConte
folder: 3_personajes/principales
description: Detective veterano...
tags:
  - damian-diconte
  - detective
facciones: []
---

Ejemplo 3: Personaje sin Campo Facciones

---
titulo: Dr. Francisco de la Cruz
carpeta: 3_personajes/principales
descripcion: Decano de Historia, líder de los Guardianes de la Memoria
tags:
  - francisco-de-la-cruz
---

Error detectado:

❌ Campo facciones OBLIGATORIO para personajes