AGENTS.md — Bóveda Ryukami Labs

Bóveda Obsidian de Alejandro (alexwce). PKM técnica, proyectos y archivo personal. Idioma de trabajo: español.

Regla de oro

Antes de crear o modificar una nota, carga estas dos skills:

.agents/skills/vault-ingest/SKILL.md → dónde va, cómo se llama, frontmatter, dedupe, enlaces y validación.
.agents/skills/obsidian-scorch-design/SKILL.md → estilo visual, callouts, tablas y HTML/SVG.

Si falta una de las dos, la nota queda mal clasificada o mal diseñada.

Para consultar sin gastar contexto, usa el protocolo de vault-query (abajo).

Cómo leer esta bóveda (protocolo para agentes)

Regla: no leer la bóveda entera. Resolver con la mínima cantidad de texto.

Paso	Acción	Coste aprox.
1	`vault find "<tema>"`	100–300 tokens
2	`vault read "<stem>" --body`	solo la nota
3	Si no hay match: `vault search "<texto>" --lines`	200–600 tokens
4	Panorama de área: `03_Conocimiento/index.md` o `04_Proyectos/index.md`	2–3k tokens
5	Vista global: `02_Meta/VAULT_MAP.md`	~5k tokens

Nunca leer 02_Meta/vault.index.json completo ni abrir una carpeta entera “por si acaso”. Es para vault/jq, no para el prompt.
Si vault no está en PATH: .agents/skills/vault-query/scripts/vault <comando>.
Si find devuelve varios candidatos, usa vault info "<stem>" para desambiguar antes de leer.
vault broken, vault doctor y vault stats son chequeos de salud, no lectura de contenido.
Antes de conclusiones globales, verifica con vault stats y vault doctor.

Mapa de la bóveda

Carpeta	Contenido
`00_Lienzos/`	Canvas visuales (`.canvas`)
`01_Inbox/`	Captura rápida sin clasificar
`02_Meta/`	Home, Dashboard.base, Templates, Assets
`03_Conocimiento/`	IA, Linux, Web Dev, A11y, Skills & Agentes
`04_Proyectos/`	Proyectos privados, públicos, Obsidian Apps, Curso Dev Env
`05_Personal/`	Trámites, tradiciones, vida personal
`06_Diario/`	Bitácora diaria `YYYY-MM-DD.md`

Flujo obligatorio para guardar información

Clasificar con la tabla de routing de vault-ingest (§2).
Buscar duplicados (rg -il, ls) antes de crear.
Escribir con frontmatter canónico:

---
title: "Título legible"
description: "Una línea con qué es y para qué sirve (≤120 caracteres)."
tipo: concepto
estado: activo
tags:
  - ia/agentes
creado: YYYY-MM-DD
actualizado: YYYY-MM-DD
---

Enlazar desde index.md (y 02_Meta/Home.md si es proyecto o skill).
Validar:

python3 .agents/skills/obsidian-scorch-design/scripts/validate_vault_note.py "<ruta>"

Reindexar para que el catálogo de agentes incluya la nota:

python3 .agents/skills/vault-query/scripts/build_index.py --write

Reglas fijas

tipo solo admite la taxonomía cerrada: moc, inbox, diario, personal, proyecto, stack, curso, skill, concepto, guia, guia-arquitectura, guia-infraestructura, guia-herramienta, referencia, recurso, herramienta.
estado: activo, produccion, desarrollo, completado, archivado.
Nombres de archivo en Title Case con espacios (kebab-case solo en docs técnicas), sin emojis ni acentos.
No renombrar, mover ni borrar notas existentes sin confirmación.
No crear carpetas nuevas sin confirmación.
No guardar secretos, tokens, claves ni .env.
No hacer git commit / git push salvo pedido explícito.
Si falta un dato, escribir por confirmar; no inventarlo.

Comandos útiles

# Consultar sin leer toda la bóveda
vault find "palabra clave"
vault read "<stem>" --body
vault info "<stem>"
vault map 03
vault search "texto exacto" --lines
 
# Validar una nota o toda la bóveda
python3 .agents/skills/obsidian-scorch-design/scripts/validate_vault_note.py .
 
# Buscar antes de crear
rg -il "palabra clave" --glob '*.md' .
 
# Regenerar y verificar el catálogo de agentes
python3 .agents/skills/vault-query/scripts/build_index.py --write
python3 .agents/skills/vault-query/scripts/build_index.py --check

Skills del workspace

vault-ingest — captura, routing, dedupe y cierre de ciclo.
obsidian-scorch-design — diseño Scorch/Velgrynd v4.1, callouts y validación estética.
vault-query — protocolo de lectura, wrapper vault, índice JSON y mapa global.

RYUKAMI LABS

[ 0xEXPLORER ]

AGENTS