🌱 Empieza aquí · Sincroniza tu directorio de personas con la nómina y el ERP

Esta semilla le enseña a tu asistente un método de trabajo: mantener tu wiki de fichas de personas y su organigrama fieles a dos fuentes duras —el CSV de nómina y el ERP— sin que las captures a mano ni se queden viejas. Cruza las fuentes, no confunde a dos personas con nombre parecido, marca de dónde salió cada dato y arma el organigrama solo con las fichas.

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 el resto y al final te dice cómo comprobar que quedó lista. 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 método de sincronizar la wiki de personas con la nómina", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un workflow (método de trabajo), no un programa ejecutable. No es un hook (gancho de automatización): 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 al arrancar una conversación, para aplicarlo cuando la persona te pida sincronizar su wiki de personas.

1. Copia el método donde lo leas siempre

El kernel trae dos archivos:

• kernel/sincronizar-wiki-personas.md — el método en sí (las 4 reglas de oro, las 4 fases y el autochequeo).
• kernel/fuentes-y-alias.ejemplo.md — una plantilla para aterrizar las rutas y la tabla de alias a este sistema (paso 2).

Coloca sincronizar-wiki-personas.md en el lugar que tu plataforma carga como instrucción permanente:

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

mkdir -p "$HOME/.claude/rules"
cp kernel/sincronizar-wiki-personas.md "$HOME/.claude/rules/sincronizar-wiki-personas.md"

Windows (PowerShell):

New-Item -ItemType Directory -Force -Path "$HOME\.claude\rules" | Out-Null
Copy-Item "kernel\sincronizar-wiki-personas.md" "$HOME\.claude\rules\sincronizar-wiki-personas.md"

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Copia ahí solo sincronizar-wiki-personas.md. La plantilla de fuentes NO va en esa carpeta (no es una regla, es una guía que usas en el paso 2).

Cowork: usa la misma carpeta de reglas si tu proyecto la soporta (.claude/rules/sincronizar-wiki-personas.md). Si no, coloca el archivo dentro del proyecto y agrega una línea que apunte a él en el archivo de instrucciones del proyecto (el CLAUDE.md): "Aplica el método de sincronizar-wiki-personas.md cuando haya que reconciliar la wiki de personas con la nómina y el ERP."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de sincronizar-wiki-personas.md dentro de AGENTS.md (o agrégale un puntero al archivo si lo guardas aparte en el proyecto), para que el método se cargue con el resto de tus instrucciones.

2. Aterriza las fuentes y los alias a ESTE sistema (recomendado)

Abre kernel/fuentes-y-alias.ejemplo.md. Con la persona (o detectándolo tú), reemplaza los placeholders por las rutas reales de su equipo:

• <TU-CSV-NOMINA> → el archivo del CSV de nómina.
• <TU-EXPORT-ERP> → el export o la consulta del ERP.
• <TU-WIKI-PERSONAS> → la carpeta donde viven las fichas de personas.
• <TU-ORGANIGRAMA> → el archivo del organigrama.
• <TU-TABLA-ALIAS> → dónde vive (o vivirá) la tabla de alias anti-confusión.

Llena también las primeras filas de la tabla de alias con los nombres o apodos que en ese equipo se confunden más.

Cuando las tablas estén listas, pega esas filas dentro de la sección "Tus fuentes y tu tabla de alias" del sincronizar-wiki-personas.md que copiaste en el paso 1 (el que quedó en ~/.claude/rules/, o dentro de AGENTS.md en Codex). Ese es el paso que cierra el círculo: como esa sección se carga sola al arrancar cada sesión, el método apunta directo a los archivos reales de la persona sin que nadie tenga que recordárselo. El fuentes-y-alias.ejemplo.md solo fue el borrador de trabajo.

Si la persona todavía no sabe dónde vive cada cosa, no pasa nada: deja los placeholders <...>, el método funciona con las categorías genéricas y se afina después.

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 método se aplica de verdad.

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

ls -la "$HOME/.claude/rules/sincronizar-wiki-personas.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 método se aplica (prueba de comportamiento, en una conversación nueva): Pídele a la persona que abra una sesión nueva y te diga algo como: "cambió el CSV de nómina, sincroniza la wiki de personas" (con dos personas de nombre parecido en la lista, a propósito). La conducta correcta es que primero resuelvas la identidad de cada registro pasando por la tabla de alias, marques de dónde sale cada dato, derives el organigrama de las fichas, y corras el autochequeo (bidireccional al 100% y cero confusión de alias) antes de decir "listo". Si en vez de eso fusionas a las dos personas parecidas o inventas un dato que ninguna fuente traía, el método no se cargó: revisa que el archivo esté en la carpeta de reglas (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 cambie tu nómina o quieras refrescar el organigrama, tu asistente reconcilia la wiki de personas contra la fuente oficial en vez de capturar a mano. Vas a notar tres cosas:

• Nadie se confunde. Dos personas con nombre parecido nunca se fusionan: si hay duda, te pregunta antes de escribir.
• Cada dato tiene procedencia. Sabes de dónde salió cada valor, y los datos sensibles nunca se cuelan desde una fuente que no les corresponde.
• El organigrama se arma solo. Sale de las fichas, así que no tienes dos versiones que se contradicen.

No tienes que hacer nada especial en el día a día. Solo pídele que sincronice cuando cambie la nómina. Eso es todo. 🌱