🌱 Empieza aquí · Mapa de qué bloquea qué

Esta semilla le enseña a tu asistente a leer tu backlog y armar el mapa de dependencias: qué proyecto depende de qué, cuál es la cadena que fija tu fecha de entrega, y quién está cargando más frentes de los que puede. Así ves los bloqueos antes de que te frenen, no después.

backlog = tu lista de proyectos o pendientes en curso. dependencia = cuando un ítem necesita a otro para poder avanzar. ruta crítica = la cadena más larga de bloqueos que determina lo más pronto que puedes llegar a tu meta. WIP = trabajo en curso; cuántos frentes abiertos a la vez.

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 coloca todo en su lugar 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 mapa de dependencias", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un skill (habilidad): un archivo de instrucciones que se dispara solo cuando la persona pide ver qué bloquea qué o la ruta crítica. No es un hook (no lleva chmod, no lleva entrada en settings.json, no ejecuta ningún script por su cuenta). Se "siembra" colocando SKILL.md en la carpeta de skills de la plataforma.

1. Copia el skill donde la plataforma lo cargue

El kernel trae dos archivos:

• kernel/SKILL.md — el método completo, con su frontmatter name + description que es el disparador. Este es el que se copia a la carpeta de skills.
• kernel/ficha-ejemplo.md — una ficha de muestra que enseña cómo se declara una dependencia en el encabezado de un proyecto. NO se copia a la carpeta de skills; es solo de referencia para el paso 2 (y para que la persona la copie en sus propias fichas).

Claude Code (macOS / Linux):

mkdir -p "$HOME/.claude/skills/safe-lord-dependency-detector"
cp kernel/SKILL.md "$HOME/.claude/skills/safe-lord-dependency-detector/SKILL.md"

Claude Code (Windows · PowerShell):

New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills\safe-lord-dependency-detector" | Out-Null
Copy-Item "kernel\SKILL.md" "$HOME\.claude\skills\safe-lord-dependency-detector\SKILL.md"

Cowork: usa la misma carpeta de skills si tu proyecto la soporta (.claude/skills/safe-lord-dependency-detector/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, por ejemplo: "Cuando la persona pida el mapa de dependencias o la ruta crítica, aplica el método de SKILL.md del mapa de qué bloquea qué."

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

2. Aterriza la configuración a ESTE sistema (recomendado)

El método usa placeholders que conviene aterrizar a cómo vive de verdad el backlog de la persona. Abre el SKILL.md que copiaste y reemplaza:

• <TU-CARPETA-DE-BACKLOG> → la carpeta (o carpetas) donde vive un archivo por proyecto/ítem. Si la persona no la sabe, pregúntale dónde guarda el estado de sus proyectos (recuerda: deben ser archivos de texto, uno por proyecto, con sus dependencias declaradas en el encabezado).
• <CAMPO-DEPENDS-ON> → el campo del encabezado donde se lista de qué depende cada ítem (por defecto depends_on).
• <CAMPO-FEEDS-INTO> → el campo donde se lista a qué alimenta cada ítem (por defecto feeds_into).
• <CAMPO-DE-ESTADO> → el campo que dice si un ítem está terminado, en curso o pendiente (por ejemplo status: o estado:).
• <CAMPO-DE-DUEÑO> → el campo que dice quién es dueño de cada ítem (por ejemplo owner:). Es opcional; sin él no se detecta la sobrecarga de dueños.
• <CAMPO-DE-DURACION> → el campo que estima cuántos días toma cada ítem (por ejemplo duracion_dias:). Es opcional; es lo único que permite medir la ruta crítica en días (sin él, la cadena se mide en número de eslabones, no en días).
• <TU-FECHA-ANCLA> → la fecha meta contra la que se mide el margen de la ruta crítica (tu entrega, tu lanzamiento). Es opcional; el margen en días solo sale si además hay duración por ítem.
• <TOPE-DE-WIP> → cuántos frentes activos como máximo puede llevar un dueño a la vez (por defecto 3).

¿No sabes cómo se ve una ficha con dependencias declaradas? Abre kernel/ficha-ejemplo.md: trae un encabezado de muestra listo para copiar, con los campos y los tipos ya puestos.

La carpeta del backlog sí hace falta de verdad: sin fichas que leer, el método no tiene qué mapear. Si la persona no la sabe, pregúntale dónde guarda el estado de sus proyectos. Los demás campos son opcionales: si no los sabe, deja el placeholder y el método usa sus defaults (depends_on, feeds_into, tope de WIP = 3).

3. Verificación post-siembra (obligatoria)

Como es un skill (texto), la verificación tiene dos partes: que el archivo quedó en su lugar, y que el mapa de verdad corre.

a) El archivo quedó colocado (Claude Code, macOS / Linux):

ls -la "$HOME/.claude/skills/safe-lord-dependency-detector/SKILL.md"; echo "exit=$?"

Salida esperada: una línea que lista el archivo (con su tamaño) y exit=0. En Windows, el equivalente es Test-Path "$HOME\.claude\skills\safe-lord-dependency-detector\SKILL.md" (debe devolver True). Si sale No such file or directory, la copia no se hizo; repite el paso 1.

b) El mapa corre (prueba de comportamiento, en una conversación nueva): Pídele a la persona que abra una sesión nueva y diga "arma el mapa de dependencias de mi backlog" o "qué bloquea qué". La conducta correcta es que el asistente liste las dependencias declaradas entre los ítems con su tipo (bloquea / habilita / alimenta / comparte), muestre la ruta crítica hacia la fecha meta y señale los bloqueos activos y los dueños sobrecargados. Si en vez de eso inventa dependencias que nadie declaró, o no distingue las duras de las suaves, revisa que SKILL.md esté en la carpeta de skills (o dentro de AGENTS.md en Codex) y que la carpeta del backlog esté bien apuntada en el paso 2.

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 preguntes "qué bloquea el proyecto X" o "cuál es la ruta crítica", tu asistente te va a entregar el mapa: quién depende de quién y con qué tipo de dependencia, cuál es la cadena que fija tu fecha de entrega y cuánto margen te queda, qué bloqueos están activos con una idea para destrabarlos, y quién está cargando demasiados frentes a la vez. Y nunca te inventa una dependencia: si algo no está declarado, te lo pregunta en vez de suponerlo. Menos sorpresas a medio camino, más claridad de en qué orden mover las piezas. 🌱