🌱 Empieza aquí · Analista de funnel de contenido

Publicas, la pieza vuela (o no)… y ahí muere la historia. Rara vez alguien se sienta a medir en serio qué funcionó, por qué, y qué cambiar la próxima vez. Esta semilla instala a tu asistente un analista de funnel: un medidor que, 24-48 horas después de cada publicación, agarra los números reales, los compara contra las metas que te fijaste, diagnostica por qué salió como salió, y te entrega recomendaciones concretas para la siguiente ronda. Convierte "publicar y olvidar" en "publicar, medir, aprender, mejorar".

¿Qué es un "funnel"? Es el embudo que recorre alguien desde que ve tu contenido por primera vez (alcance) hasta que se vuelve cliente fiel (retención), pasando por interés, consideración y conversión. Cada etapa se mide con métricas distintas. Este analista las mide todas.

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 analista de funnel", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un agente (un subagente especializado), no un hook ni un script: no lleva chmod, no lleva entrada en settings.json y no ejecuta nada por sí solo. Se "siembra" colocando su definición en la carpeta de agentes de la plataforma, para que quede disponible como un analista invocable.

1. Copia el agente a la carpeta de agentes

El kernel trae dos archivos:

• kernel/funnel-analyst.md — la definición del agente analista (lo que se instala).
• kernel/kpis-y-benchmarks.ejemplo.md — una plantilla para aterrizar la medición a los KPIs y umbrales reales de esta persona.

Coloca funnel-analyst.md en la carpeta de agentes (Claude Code y Cowork comparten la misma):

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

mkdir -p "$HOME/.claude/agents"
cp kernel/funnel-analyst.md "$HOME/.claude/agents/funnel-analyst.md"

Los archivos dentro de ~/.claude/agents/ quedan disponibles como subagentes que el asistente puede invocar. La plantilla de KPIs NO va en esa carpeta (no es un agente, es una guía que usas en el paso 2).

Nota de compatibilidad: este componente es un agente (un subagente con nombre propio). Claude Code y Cowork lo instalan igual: copiándolo a la carpeta de agentes ~/.claude/agents/, que ambos comparten. Codex usa otro mecanismo de agentes, así que ahí no se instala como subagente delegable; en ese caso pega el contenido de funnel-analyst.md dentro de tu archivo AGENTS.md para usarlo como método de análisis a mano.

2. Aterriza los KPIs a ESTA operación (muy recomendado)

El analista solo es tan bueno como los umbrales que lee. Abre kernel/kpis-y-benchmarks.ejemplo.md. Con la persona (o detectándolo tú de sus documentos), llena la plantilla: dónde vive su carpeta de briefs, su config de etapas y su bitácora de aprendizajes; qué umbral tiene cada KPI por etapa; y qué benchmarks externos usa. Guárdala donde el asistente pueda leerla y, en funnel-analyst.md, reemplaza los placeholders <TU-CARPETA-DE-BRIEFS>, <TU-CONFIG-DE-ETAPAS>, <TU-BITACORA-DE-APRENDIZAJES> y <TUS-BENCHMARKS-DE-PLATAFORMA> por las rutas reales.

Si la persona todavía no tiene umbrales escritos, no pasa nada: el analista trabaja con lo que haya y marca como "por confirmar" lo que no pueda validar, en vez de inventárselo. Pero cinco minutos llenando la plantilla le suben la puntería muchísimo.

3. Verificación post-siembra (obligatoria)

a) El archivo quedó colocado:

ls -la "$HOME/.claude/agents/funnel-analyst.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 analista mide de verdad (prueba de comportamiento): dale al asistente los datos de una pieza de ejemplo (por ejemplo: "una publicación de alcance con umbral de 5,000 y un alcance real de 8,240") y pídele que use el analista de funnel para evaluarla. La conducta correcta es que compare real contra umbral, calcule el delta ("+64%"), emita un veredicto (SUPERÓ / CUMPLIÓ / POR DEBAJO) y proponga una recomendación accionable. Si en vez de eso inventa números que no le diste o da un consejo genérico ("publica más"), revisa que funnel-analyst.md esté en la carpeta de agentes y que sepa cuál es el umbral.

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, después de publicar ya no te quedas con la duda de "¿estuvo bien o no?". Le pides a tu asistente que corra el analista de funnel y te devuelve un reporte claro: qué números salieron, si cumplieron tus metas, por qué la pieza jaló o no jaló, y qué ajustar la próxima vez —todo con el número que lo justifica, nunca a corazonada. Menos adivinar, más mejorar ronda con ronda. Ese es todo el punto. 🌱