🌱 Empieza aquí · Narrador de avance del incremento
Esta semilla le enseña a tu asistente a escribir el reporte de avance de un bloque de sprints (un "incremento de programa") para presentárselo a quien decide. Con un solo dato —cuántos sprints abarca— arma el reporte completo: si le dices cero, escribe el plan inicial; si le dices un número mayor, escribe el acumulado de lo que ya cerró. Y en vez de porcentajes inventados, muestra la evidencia real y te deja a ti poner el número final.
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 narrador de avance del incremento", "haz el setup de esto". Te entiende igual.
Para el asistente que siembra 🤖
Este componente es un skill (una habilidad de método): texto que tú, el asistente,
lees y aplicas cuando la persona pide el reporte. 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 skill donde tu plataforma lo cargue y lo dispare solo.
1. Copia el skill donde tu plataforma lo dispare
El kernel trae un archivo: kernel/SKILL.md, con el método completo.
Claude Code (macOS / Linux / Windows con Git Bash):
mkdir -p "$HOME/.claude/skills/narrador-avance-incremento"
cp kernel/SKILL.md "$HOME/.claude/skills/narrador-avance-incremento/SKILL.md"
Windows (PowerShell):
New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills\narrador-avance-incremento" | Out-Null
Copy-Item "kernel\SKILL.md" "$HOME\.claude\skills\narrador-avance-incremento\SKILL.md"
Cowork: usa la misma carpeta de skills si tu proyecto la soporta
(.claude/skills/narrador-avance-incremento/SKILL.md). Si no, coloca SKILL.md dentro
del proyecto y agrega una línea que apunte a él en el archivo de instrucciones del
proyecto (el CLAUDE.md), por ejemplo: "Cuando pidan el reporte de avance del
incremento, aplica el método de SKILL.md."
Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de
kernel/SKILL.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 a ESTE sistema (recomendado)
El método lee dos cosas del disco de la persona. Ubícalas (pregúntale o detéctalas) y
reemplaza los placeholders del SKILL.md que copiaste:
<TU-ARCHIVO-DE-OKRS>→ el archivo donde viven los objetivos del periodo y sus resultados clave (por ejemplo, unobjetivos-2026.md).<TU-CARPETA-DE-RETROS>→ la carpeta con las notas de cierre de cada sprint (los archivos de retro).<SPRINTS-POR-PI>→ cuántos sprints forman un incremento en la cadencia de la persona (si no lo sabe, un default común es cinco).
Si la persona no sabe dónde vive cada cosa, no pasa nada: deja los placeholders y el método sigue explicado; solo le preguntará esos datos al generar el reporte.
Truco de reparto automático: si las retros de la persona traen en cada logro una etiqueta corta que diga a qué frente y a qué resultado clave pertenece (por ejemplo:
· frente: O2 · resultado: KR2.1 · fuente: retro-sprint-03.md), el método reparte la evidencia solo, sin adivinar. Sugiérele adoptar esa etiqueta en sus retros.
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 método se dispara y hace lo correcto.
a) El archivo quedó colocado (ejemplo Claude Code):
ls -la "$HOME/.claude/skills/narrador-avance-incremento/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 método se aplica (prueba de comportamiento): Pídele a la persona que abra una conversación y diga: "escribe el reporte de avance del incremento, con el dial en cero (el plan inicial)". Para esta prueba conviene tener ya ubicado el archivo de objetivos del paso 2; si aún no lo tiene, tu asistente se lo preguntará antes de armar las tarjetas, y eso también es correcto. La conducta correcta es que tu asistente:
- Arme una tarjeta por cada objetivo del archivo de objetivos (existen aunque no haya avance todavía).
- No ponga ninguna barra de progreso ni porcentaje (con el dial en cero es propuesta, no acumulado).
- Deje los datos que no encuentre marcados como "por confirmar", sin inventarlos.
Luego que lo pruebe con el dial en un número mayor a cero (si ya hay retros escritas): ahí
debe aparecer el avance como evidencia + rango, con el hueco [%: lo curas tú] en vez
de un porcentaje inventado, y cualquier proyecto cancelado en la retro más reciente debe
salir en "Cancelados / pausados", nunca en "En marcha". Si en vez de eso inventa un
porcentaje o revive algo cancelado, el método no se cargó: revisa que el 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 pidas el reporte de avance de tu bloque de sprints, tu asistente lo arma solo con un solo dato: cuántos sprints abarca. Te va a entregar el documento con sus tarjetas por frente, el avance sostenido en evidencia (no en porcentajes inventados), los pivotes fechados y lo cancelado bien apartado. El número final de cada barra de progreso te lo deja a ti, ya con toda la evidencia enfrente para que lo pongas con criterio. Menos reporte armado a mano, cero números falsos. 🌱