🌱 Empieza aquí · Navegador de tu base de conocimiento

Esta semilla le enseña a tu asistente a ser el GPS de tus archivos. Cuando le mencionas a una persona, un proyecto, un cliente o una decisión tuya, primero busca su ficha por nombre —resolviendo apodos y nombres parecidos sin confundirse— y solo después rastrea el resto de tu sistema. Te dice qué leer y cuándo, sin volver a copiarte lo que ya vive en un archivo.

Para instalarla

Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente hace todo lo demás y al final te dice cómo comprobar que quedó funcionando. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.

¿Otras formas de pedírselo? "instala esta semilla", "pon a funcionar el navegador de mis archivos", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un skill (una habilidad que se carga sola): texto puro, sin programa ejecutable. No lleva chmod, no lleva entrada en settings.json y no ejecuta ningún script. Se "siembra" colocando el método donde tú, el asistente, lo leas de forma automática, y aterrizándolo al sistema real de la persona.

El kernel trae dos archivos:

• kernel/SKILL.md — el navegador en sí (el método que vas a seguir).
• kernel/tabla-de-entidades.ejemplo.md — una plantilla para apuntar el navegador a las rutas y los nombres reales de esta persona.

1. Copia el skill donde lo cargues siempre

Claude Code (macOS / Linux / Windows con Git Bash):

mkdir -p "$HOME/.claude/skills/navigator"
cp kernel/SKILL.md "$HOME/.claude/skills/navigator/SKILL.md"

Los skills dentro de ~/.claude/skills/ se descubren solos: el asistente los activa cuando la descripción del skill coincide con lo que pide la persona.

Windows (PowerShell, sin Git Bash):

New-Item -ItemType Directory -Force "$HOME\.claude\skills\navigator" | Out-Null
Copy-Item kernel\SKILL.md "$HOME\.claude\skills\navigator\SKILL.md"

Cowork: usa la misma carpeta de skills si tu proyecto la soporta (.claude/skills/navigator/SKILL.md). Si no, coloca SKILL.md dentro del proyecto y agrega en el archivo de instrucciones del proyecto (el CLAUDE.md) una línea que apunte a él: "Cuando la persona pida orientar/ubicar sus archivos o mencione una entidad suya, aplica el método de SKILL.md."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de kernel/SKILL.md (el cuerpo, no hace falta el bloque de arriba entre ---) dentro de AGENTS.md, o agrégale un puntero al archivo si lo guardas aparte en el proyecto.

2. Aterriza el navegador a ESTE sistema (recomendado)

Abre kernel/tabla-de-entidades.ejemplo.md. Con la persona (o detectándolo tú), llena:

• La raíz de su base de conocimiento (<TU-RUTA-RAIZ>).
• La tabla de rutas (dónde vive cada tipo de nota: personas, proyectos, decisiones).
• La tabla de apodos (los nombres que podrían confundirse y cómo distinguirlos).
• El índice de proyectos (cómo los identifica).

Guarda ese archivo lleno con el nombre contexto.md, en la misma carpeta del skill (~/.claude/skills/navigator/contexto.md): el SKILL.md lo busca ahí por convención y lo carga al inicio de cada navegación. En Cowork guárdalo junto al SKILL.md del proyecto (.claude/skills/navigator/contexto.md); en Codex, como no hay carpeta de skills, pega la tabla llena dentro del mismo AGENTS.md donde copiaste el método, justo debajo de él. Si la persona todavía no sabe dónde vive cada cosa, no pasa nada: deja los placeholders y el método sigue funcionando con categorías genéricas.

3. Verificación post-siembra (obligatoria)

Como es un método (texto), la verificación tiene dos partes: que el archivo quedó en su lugar, y que el navegador se aplica de verdad.

a) El archivo quedó colocado (ejemplo Claude Code):

ls -la "$HOME/.claude/skills/navigator/SKILL.md"; echo "exit=$?"

Salida esperada: una línea que lista el archivo (con su tamaño) y exit=0. Si sale No such file or directory, la copia no se hizo; repite el paso 1.

b) El navegador se aplica (prueba de comportamiento, en una conversación nueva): Pídele a la persona que abra una sesión nueva y mencione una entidad suya, por ejemplo: "¿quién es [alguien de su equipo]?" o "trabajemos en [algún proyecto suyo]". La conducta correcta es que primero busques su ficha por nombre y apuntes al archivo concreto, y si el nombre es ambiguo, preguntes cuál es antes de abrir nada en vez de adivinar. Si en cambio te lanzas a inventar quién es o abres una nota equivocada, el método no se cargó: revisa que SKILL.md esté en la carpeta de skills (o dentro de AGENTS.md en Codex).

Cuando ambas partes pasen, avísale a la persona en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

De ahora en adelante, cuando le menciones a tu asistente a una persona, un proyecto o una decisión tuya, en vez de preguntarte "¿y ese quién es?" o de adivinar, va a ir derechito a la ficha correcta y te va a decir de dónde sacó la información. Y cuando dos nombres se parecen, en lugar de confundirlos, te va a preguntar cuál es antes de tocar nada.

No tienes que hacer nada especial en el día a día. Solo vas a notar que tu asistente se ubica en tus archivos como si se los supiera de memoria, y que ya no confunde a una persona con otra. Eso es todo. 🌱