Empieza aquí 🌱

Dile a tu asistente: "siembra esta semilla 🌱"

Con eso basta. Tu asistente hace todo lo técnico por ti. Tú solo confirmas cuando te pregunte.

¿Otras formas de pedirlo? "instala esta semilla", "activa este agente", "pon el debugger a funcionar". Te entiende igual.

Esta semilla instala un agente (subagente): un ayudante especializado que tu asistente puede invocar para investigar bugs con método. En lugar de tirar el primer parche que se le ocurre, primero reproduce el problema, encuentra la causa raíz (no el síntoma), y no dice "listo" hasta demostrar con evidencia que de verdad quedó.

Para el asistente que siembra 🤖

Eres el asistente. Sigue estos pasos con precisión. Esto es un agente de Claude Code / Cowork (un subagente con nombre propio), no un hook ni un script: se instala copiando un solo archivo Markdown a la carpeta de agentes del usuario. La plataforma lo descubre automáticamente al leer esa carpeta.

Paso 1 · Copiar el archivo del kernel

El kernel es un solo archivo: kernel/debugger.md. Cópialo a la carpeta de agentes del usuario según su plataforma.

• macOS / Linux (Claude Code o Cowork):

  mkdir -p ~/.claude/agents
  cp kernel/debugger.md ~/.claude/agents/debugger.md
  

• Windows (Claude Code o Cowork):

  mkdir -p "$USERPROFILE/.claude/agents"
  cp kernel/debugger.md "$USERPROFILE/.claude/agents/debugger.md"
  

Sin chmod y sin settings.json. A diferencia de un hook, un agente es un archivo de texto que la plataforma lee, no un programa que se ejecute. No necesita permisos de ejecución ni cablearse en settings.json. Con copiarlo a la carpeta agents es suficiente: Claude Code y Cowork lo detectan solos.

Paso 2 · Verificación post-siembra (obligatoria)

No declares "listo" sin correr esto. Confirma que el archivo llegó a su sitio y que su encabezado (frontmatter) quedó bien formado.

grep -m1 '^name:' ~/.claude/agents/debugger.md

Salida esperada:

name: debugger

En Windows, cambia ~ por "$USERPROFILE". Si no imprime nada, revisa que el archivo se haya copiado a la carpeta agents (no a hooks) y que el nombre sea exactamente debugger.md.

Como comprobación adicional en una sesión interactiva de Claude Code, el comando /agents debe listar debugger entre los agentes disponibles. Si aparece ahí, ya se puede invocar.

Placeholders y configuración

El kernel trae un solo placeholder, y es opcional:

• <TU-ARCHIVO-DE-APRENDIZAJES> — aparece en las secciones "Consulta tus aprendizajes" y "Mejora continua". Sirve si el usuario quiere que el agente vaya acumulando los bugs ya diagnosticados en un archivo propio (por ejemplo ~/.claude/agents/learnings/debugger.md), para no investigar dos veces el mismo error. Si al usuario no le interesa esa memoria manual, déjalo tal cual o borra esas secciones: el agente funciona igual, porque ya trae memory: project para memoria automática por proyecto.

Ajustes opcionales que el usuario puede pedirte más adelante (edítalos dentro del .md):

• Modelo — la línea model: opus. Depurar es una tarea de razonamiento, por eso el default es un modelo fuerte; cámbiala si el usuario prefiere otro.
• Plugin superpowers (opcional): si el usuario lo tiene instalado, el agente aprovecha automáticamente sus habilidades systematic-debugging y verification-before-completion. Si NO lo tiene, no pasa nada: el agente trae el mismo método por dentro y funciona igual. No necesitas instalar nada extra para sembrar esta semilla.

¿Cómo sé que funcionó?

Cuando tu asistente termine, pídele que corra la verificación de arriba y te muestre el resultado. Si aparece name: debugger, ya quedó sembrado.

Para probarlo de verdad, la próxima vez que algo se rompa, dile algo como: "este bug no lo entiendo, investígalo" o "el test está flakeando, ¿por qué?". Tu asistente invocará al debugger, que primero reproducirá el problema, aislará la causa raíz, y te entregará un diagnóstico con el fix mínimo propuesto y un plan para verificar que quedó. Lo que no hará —y ese es justo el punto— es aventarte un parche a ciegas y decir "ya quedó" sin pruebas.