🌱 Empieza aquí · Sincronización de tu configuración entre varias máquinas

Esta semilla le enseña a tu asistente un método para mantener su carpeta de configuración idéntica entre todas tus computadoras (por ejemplo tu Mac y tu Windows), usando un repositorio git como puente. Se sincroniza sola al arrancar y al cerrar cada sesión, junta los cambios de ambas máquinas sin que una pise a la otra, y bloquea que se filtren tus credenciales. Tú no vuelves a escribir un comando git.

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", "configura la sincronización entre mis máquinas", "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 por sí mismo. Se "siembra" en dos partes: (1) colocas el método donde tú, el asistente, lo leas automáticamente al arrancar cada sesión, y (2) colocas la plantilla gitattributes.ejemplo dentro del repo puente de la persona.

Alcance honesto de esta semilla. Es la arquitectura y las reglas del sistema de sincronización (el puente git, el ciclo de cuatro momentos, merge=union, el escaneo de secretos y la escala de conflictos). Los scripts concretos de cada uno de los cuatro ganchos y el escáner de secretos son piezas aparte que se construyen siguiendo este método; no viajan dentro de esta semilla. Este documento es el plano que los coordina.

1. Copia el método donde lo leas siempre

El kernel trae dos archivos:

• kernel/sincronizacion-cross-machine.md — el método en sí (la arquitectura y las reglas).
• kernel/gitattributes.ejemplo — la plantilla anti-conflicto para el repo puente.

Coloca el método en el lugar que tu plataforma carga automáticamente como instrucción permanente:

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

mkdir -p "$HOME/.claude/rules"
cp kernel/sincronizacion-cross-machine.md "$HOME/.claude/rules/sincronizacion-cross-machine.md"

Windows (PowerShell):

New-Item -ItemType Directory -Force -Path "$HOME\.claude\rules" | Out-Null
Copy-Item "kernel\sincronizacion-cross-machine.md" "$HOME\.claude\rules\sincronizacion-cross-machine.md"

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Copia ahí solo el método. La plantilla gitattributes.ejemplo NO va en esa carpeta (no es una regla; es un archivo de configuración para el repo, ver el paso 2).

Cowork: usa la misma carpeta de reglas si tu proyecto la soporta (.claude/rules/sincronizacion-cross-machine.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), por ejemplo: "Aplica siempre el método de sincronizacion-cross-machine.md para sincronizar mi configuración entre máquinas."

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

2. Coloca la plantilla anti-conflicto en el repo puente (recomendado)

Si la persona ya tiene (o quiere crear) un repo git que sirva de puente para su carpeta de configuración, aterriza la plantilla gitattributes.ejemplo:

• Abre kernel/gitattributes.ejemplo.
• Reemplaza el placeholder <TU-ARCHIVO-DE-MEMORIA> por la ruta real del archivo de memoria de la persona (en Claude Code / Cowork suele ser memory/MEMORY.md), y ajusta los patrones **/sesiones/** y **/bitacoras/** a las carpetas append-only de su sistema (las que solo crecen: logs, memoria, registros de sesiones, aprendizajes).
• Copia el resultado a la raíz del repo puente con el nombre .gitattributes:

macOS / Linux / Git Bash:

cp kernel/gitattributes.ejemplo "<TU-REPO-DE-CONFIG>/.gitattributes"

Windows (PowerShell):

Copy-Item "kernel\gitattributes.ejemplo" "<TU-REPO-DE-CONFIG>\.gitattributes"

Si la persona todavía no tiene el repo puente montado, no pasa nada: deja el método instalado (paso 1) y, cuando quiera, guíala en el arranque único del puente. El método trae el patrón exacto en su sección "El puente la primera vez": repo vacío y privado → git init en la carpeta de config + colocar el .gitattributes + primer push → clonar en la segunda máquina. Es la única vez que se toca git a mano; la plantilla .gitattributes se coloca en ese mismo arranque.

3. Verificación post-siembra (obligatoria)

Como es un método (texto) más una plantilla de configuración, 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 del método quedó colocado (ejemplo Claude Code):

ls -la "$HOME/.claude/rules/sincronizacion-cross-machine.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 pregunte: "¿cómo mantienes mi configuración sincronizada entre mis dos computadoras?". La conducta correcta es que describas el método de esta semilla: un repo git como puente (no una carpeta de nube), sincronización automática al arrancar (pull) y al cerrar (commit + push), merge=union para juntar sin conflictos los archivos que solo crecen, y un escaneo de secretos antes de cada commit que aborta si detecta credenciales. Si en vez de eso respondes cualquier otra cosa genérica, el método no se cargó: revisa que el archivo esté en la carpeta de reglas (o dentro de AGENTS.md en Codex).

b-bis) Si ya colocaste la plantilla .gitattributes (prueba de infraestructura), confirma que git la reconoce para un archivo append-only real del repo:

cd "<TU-REPO-DE-CONFIG>" && git check-attr merge memory/MEMORY.md

Salida esperada: una línea que termina en merge: union. Eso demuestra que el anti-conflicto quedó activo para ese archivo. (Ajusta memory/MEMORY.md al archivo append-only real que pusiste en la plantilla.)

Cuando las 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 abras a tu asistente en cualquiera de tus computadoras, va a ponerse al día solo con lo que hiciste en la otra: lo que editaste en una máquina aparece en la siguiente al arrancar, sin que toques git. Si ambas máquinas escribieron en el mismo archivo de bitácora o memoria, verás las dos entradas juntas, no una pisando a la otra. Y si por accidente una credencial se cuela entre tus cambios, el sistema frena el guardado antes de que llegue al puente.

No tienes que hacer nada especial en el día a día. Solo vas a notar que tus máquinas están siempre igual de al día, sin trabajo perdido y sin comandos raros. 🌱