🌱 Empieza aquí · Researcher de contenido

¿Alguna vez te sentaste a crear contenido y te frenó la duda de qué está pasando hoy en tu tema, qué le mueve a tu audiencia o qué anda diciendo la competencia? Esta semilla te instala un investigador que hace ese trabajo por ti y te entrega un resumen listo para accionar, con las fuentes citadas.

Para ti (el humano)

Solo tienes que decir una frase. Abre esta carpeta con tu asistente (Claude Code o Cowork) y escríbele:

Dile a tu asistente: siembra esta semilla 🌱

¿Otras formas de pedirlo? "instala esta semilla", "haz el setup de esto", "ponme esto a funcionar". Te entiende igual. De aquí en adelante, tu asistente hace toda la parte técnica. Tú no tocas nada.

Durante la siembra, tu asistente te va a hacer una sola pregunta fácil: dónde guardas los documentos de tu marca (quién es tu audiencia, tus pilares de contenido). Con eso el investigador afina su trabajo a lo tuyo. Si todavía no tienes esos documentos, no pasa nada: funciona igual, solo que más general.

Para el asistente que siembra 🤖

Eres el asistente que va a instalar esta semilla. Es un agente (un subagente al que se le delega la misión de investigar). No es un hook (automatización que se dispara sola ante eventos del asistente): no hay que registrar nada en settings.json ni dar permisos de ejecución (chmod) — es un archivo de definición en texto, no un script. Sigue estos pasos tal cual.

Los placeholders entre <...> los resuelves tú según la plataforma y el contexto del humano:

<TU-RUTA-DE-AGENTES> → carpeta donde viven las definiciones de agentes del asistente.
- Claude Code (usuario): ~/.claude/agents/ (recomendado, el agente queda disponible en todas las sesiones del usuario).
- Por proyecto: .claude/agents/ dentro del proyecto (si el humano solo lo quiere ahí).
- Cowork: la carpeta de configuración equivalente (~/.claude/agents/ si comparte el mismo directorio de config).
<TU-CARPETA-DE-CONTEXTO> → la carpeta del humano donde viven sus documentos de marca, audiencia y posicionamiento.
<TU-FRAMEWORK-DE-CONTENIDO> → el documento del humano con sus pilares de contenido o su sistema de identidad.

Paso 1 · Copiar la definición del agente

Copia kernel/researcher.md a <TU-RUTA-DE-AGENTES>. Crea la carpeta si no existe.

mkdir -p <TU-RUTA-DE-AGENTES>
cp kernel/researcher.md <TU-RUTA-DE-AGENTES>/researcher.md

Paso 2 · Personalizar el contexto (una pregunta al humano)

Abre el archivo que acabas de copiar y reemplaza los dos placeholders de contexto por las rutas reales del humano. Pregúntale, en lenguaje simple: "¿En qué carpeta guardas tus documentos de marca y de tu audiencia?" y "¿Tienes un documento con tus pilares de contenido?".

Sustituye <TU-CARPETA-DE-CONTEXTO> por la ruta real de esa carpeta.
Sustituye <TU-FRAMEWORK-DE-CONTENIDO> por la ruta real de ese documento.

Si el humano todavía no tiene esos documentos, no bloquees la siembra: deja los placeholders o pon una nota corta explicando que aún no existen. El agente ya está preparado para avisar y trabajar con el contexto disponible, sin inventar quién es la audiencia.

Nota sobre la ruta de aprendizajes. El agente guarda lo que aprende en ~/.claude/agents/learnings/ (sección Mejora continua, al final de researcher.md). Esa ruta está escrita para una siembra de usuario en ~/.claude/. Si sembraste en otro lado (por proyecto en .claude/agents/, o un Cowork con un directorio de config distinto), abre el archivo copiado y alinea también esas dos rutas para que apunten a la carpeta de config real; de lo contrario el agente no encontrará ni podrá guardar sus aprendizajes.

Paso 3 · VERIFICACIÓN post-siembra (obligatoria)

Primero confirma que el archivo quedó en su lugar y que su encabezado se lee bien:

ls -la <TU-RUTA-DE-AGENTES>/researcher.md && head -8 <TU-RUTA-DE-AGENTES>/researcher.md

Salida esperada — el archivo existe y su encabezado empieza así:

---
name: researcher
description: "Investiga tendencias, audiencias, competidores y temas para tu estrategia de contenido. ..."
tools: WebSearch, WebFetch, Read, Write, Glob, Grep
model: sonnet

Luego haz una prueba funcional real: pídele al agente una investigación chica y verifica que entregue el Research Brief (informe de investigación) con fuentes citadas. Desde tu propia conversación, delega:

Usa el agente researcher para investigar 2-3 tendencias recientes sobre [un tema pequeño del humano].

Qué esperar: un "Research Brief" con secciones (Hallazgos clave, Tendencias relevantes, Datos de audiencia, Recomendaciones y Fuentes con URLs reales). Si cada hallazgo trae su fuente y ninguna está inventada, el agente quedó vivo. ✅

Si el agente no aparece / no se puede invocar: confirma que copiaste el archivo a <TU-RUTA-DE-AGENTES> correcto para la plataforma (usuario vs. proyecto) y que el encabezado del Paso 3 se lee completo.
Si entrega hallazgos sin fuente: recuérdale su regla anti-alucinación; cada hallazgo necesita una URL real fetcheada (obtenida visitando la fuente real).

Cuando las dos verificaciones den lo esperado, la siembra está completa. Reporta al humano en una línea, sin tecnicismos.

¿Cómo sé que funcionó? (para el humano)

Fácil: pídele a tu asistente que "investigue con el researcher" algo de tu tema — una tendencia, qué le interesa a tu audiencia, qué está haciendo alguien más. En un rato te devuelve un resumen ordenado con lo importante y, muy importante, con los enlaces de dónde lo sacó para que puedas confiar en el dato. Si ves ese resumen con sus fuentes, ya quedó. A partir de ahora, cada vez que vayas a crear contenido, tienes un investigador de cabecera que te ahorra la parte tediosa de andar buscando. 🌱