🌱 Empieza aquí · Ficha y carpeta siempre sincronizadas

Esta semilla le enseña a tu asistente una regla de oro para tus proyectos: cada proyecto vive en dos lados a la vez —una ficha que lo describe y una carpeta donde trabajas— y esos dos lados nunca se separan. Cuando tu asistente crea o actualiza un proyecto, escribe los dos lados en el mismo movimiento y comprueba que el "puente" entre ambos apunta a algo que existe de verdad, antes de decirte que quedó listo. Resultado: cero fichas huérfanas, cero carpetas sin registrar.

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 la regla de dual- write", "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 cada conversación, para aplicar la regla por tu cuenta cada vez que crees o actualices un proyecto.

1. Copia el método donde lo leas siempre

El kernel trae dos archivos:

• kernel/dual-write-ficha-carpeta.md — el método en sí (el puente, la regla de oro y las 4 fases: diseñar → documentar → probar → iterar).
• kernel/plantilla-puente.ejemplo.md — una plantilla para aterrizar los dos lados (ficha + README de carpeta) a la estructura real de esta persona.

Coloca dual-write-ficha-carpeta.md 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/dual-write-ficha-carpeta.md "$HOME/.claude/rules/dual-write-ficha-carpeta.md"

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Copia ahí solo dual-write-ficha-carpeta.md. La plantilla 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/dual-write-ficha-carpeta.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 dual-write-ficha-carpeta.md: ficha y carpeta sincronizadas, con verificación del puente antes de cerrar."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de dual-write-ficha-carpeta.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 la plantilla a ESTE sistema (recomendado)

Abre kernel/plantilla-puente.ejemplo.md. Con la persona (o detectándolo tú), decide y reemplaza los placeholders:

• Dónde viven las fichas (ej. una carpeta wiki/proyectos/ o similar).
• Dónde viven las carpetas de trabajo (ej. una carpeta proyectos/).
• Qué campos de metadata usa de verdad esta persona (los únicos innegociables son los dos del puente: carpeta: en la ficha y ficha: en el README).
• Cómo se genera el ID estable de cada proyecto (ej. proj-NNN-nombre-corto).

Deja la plantilla ajustada a mano para reusarla cada vez que se cree un proyecto. Si la persona no sabe todavía dónde vivirá cada cosa, no pasa nada: deja las rutas de ejemplo y el método sigue funcionando igual.

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 la regla se aplica de verdad.

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

ls -la "$HOME/.claude/rules/dual-write-ficha-carpeta.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) La regla se aplica (prueba de comportamiento, en una conversación nueva): Pídele a la persona que abra una sesión nueva y te diga "crea un proyecto nuevo para [algo]". La conducta correcta es que crees los dos lados en el mismo movimiento (la ficha con su campo carpeta: y la carpeta con su README y su campo ficha:), luego verifiques que los dos punteros del puente existen y solo entonces le pidas su visto bueno. Si en vez de eso creas solo la carpeta, o dices "listo" sin comprobar el puente, el método no se cargó: revisa que dual-write-ficha-carpeta.md 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, cada vez que le pidas a tu asistente crear o actualizar un proyecto, va a dejarte los dos lados siempre en pareja: la ficha que lo describe y la carpeta donde se trabaja, apuntándose la una a la otra. Y no te va a decir "ya quedó" sin antes comprobar que el puente entre ambos apunta a algo real.

No tienes que hacer nada especial en el día a día. Solo vas a notar que tu índice de proyectos y tus carpetas siempre coinciden, que nunca aparece una ficha apuntando al vacío ni una carpeta perdida sin registrar. Eso es todo. 🌱