Organizador del Vault

Skill para gestionar, limpiar y mantener la estructura y consistencia del vault. Incluye lint proactivo inspirado en el patron LLM Wiki.

Cuando usar esta skill

Cuando el usuario quiera:

• Auditar la salud del vault (huerfanas, tags, frontmatter)
• Reorganizar notas mal ubicadas
• Limpiar tags no canonicas o duplicadas
• Validar que el frontmatter cumple el estandar
• Detectar y resolver duplicados
• Ejecutar un lint completo del vault

[!CAUTION] Antes de crear o editar notas, lee las [[.agents/REGLAS_GLOBALES|Reglas Globales]].

Operaciones de mantenimiento

Auditoria de huerfanas

1. Ejecutar links.find_orphans()
2. Para cada huerfana, evaluar:

• Tiene contenido valioso? Conectar al grafo con [[wikilinks]]
• Esta obsoleta? Proponer al usuario eliminarla
• Esta mal ubicada? Mover a la carpeta correcta

Validacion de frontmatter

Verificar que cada nota tenga los campos obligatorios:

• type, status, tags, created
• type sea uno de los valores validos (ver REGLAS_GLOBALES)
• status sea borrador, en_proceso, completo o archivo

Limpieza de tags

1. Obtener todas las tags con tags.list()
2. Identificar tags problematicas:

• Tags que representan estado (deben ir en frontmatter status)
• Tags duplicadas o sinonimas
• Tags sin uso

1. Proponer al usuario las correcciones antes de aplicar

Principio fundamental: las tags son para tematica/dominio. Estado y tipo van en frontmatter.

Deteccion de duplicados

Buscar notas con titulos similares o contenido solapado. Proponer al usuario fusionar o eliminar.

Lint proactivo (LLM Wiki health check)

Ademas de las operaciones basicas, el lint proactivo busca problemas mas profundos. Ejecutar periodicamente o cuando el usuario lo pida.

1. Contradicciones entre paginas

Buscar claims que se contradicen entre paginas diferentes:

• Leer paginas de un mismo tema/entidad
• Comparar afirmaciones sobre la misma entidad, tecnologia o proceso
• Si hay contradiccion, anotar con > [!WARNING] Posible contradiccion con [[otra-nota]] en ambas paginas

2. Claims obsoletos

Buscar informacion que puede estar desactualizada:

• Notas con updated de hace mas de 6 meses que hablan de versiones, precios, o estado de proyectos
• Proponer al usuario revisar o marcar como archivo

3. Gaps de contenido

Detectar conceptos mencionados pero sin pagina propia:

• Buscar [[wikilinks]] rotos con links.find_broken()
• Identificar terminos tecnicos que aparecen en multiples notas pero no tienen su propia pagina de conocimiento
• Proponer crear paginas para los conceptos mas referenciados

4. Cross-references faltantes

Buscar notas que deberian estar enlazadas pero no lo estan:

• Notas del mismo proyecto sin wikilinks entre si
• Notas que mencionan la misma tecnologia pero no se referencian
• Usar links.analyze() para detectar patrones

5. Notas estancadas

Buscar notas en estado borrador o en_proceso desde hace mas de 30 dias. Proponer al usuario completarlas o archivarlas.

Formato del informe de lint

Al finalizar un lint, generar un resumen en el Log:

## [YYYY-MM-DD] lint | Auditoria del vault

Resultados:
- Huerfanas: X encontradas, Y resueltas
- Frontmatter: X notas con campos faltantes
- Tags: X tags no canonicas
- Contradicciones: X detectadas
- Gaps: X conceptos sin pagina
- Cross-refs faltantes: X sugeridas
- Estancadas: X notas en borrador >30d

Arbol de decision para ubicacion

Es una nota sin clasificar?                  -> 01_Inbox
Pertenece a un proyecto con objetivo?        -> 02_Proyectos/<proyecto>/
Es conocimiento generico o aprendizaje?      -> 03_Conocimiento/<area>/
Es material externo de referencia?           -> 04_Recursos/
Es una nota de reunion o daily?              -> 05_Reuniones/
Es infraestructura del vault?                -> 00_Sistema/
Esta obsoleta o completada?                  -> ZZ_Archivo/