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 esto a funcionar". Te entiende igual.

Esta semilla instala un agente (subagente): un ayudante especializado que tu asistente puede invocar para limpiar y simplificar el código que acabas de escribir sin cambiar lo que hace. Trabaja solo sobre lo último que tocaste, corre las pruebas antes y después para no romper nada, y deja un commit ordenado.

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/refactor-agent.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/refactor-agent.md ~/.claude/agents/refactor-agent.md
  

• Windows (Claude Code o Cowork):

  mkdir -p "$USERPROFILE/.claude/agents"
  cp kernel/refactor-agent.md "$USERPROFILE/.claude/agents/refactor-agent.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/refactor-agent.md

Salida esperada:

name: refactor-agent

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 refactor-agent.md.

Como comprobación adicional en una sesión interactiva de Claude Code, el comando /agents debe listar refactor-agent 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> — solo aparece en la sección "Mejora continua". Sirve si el usuario quiere que el agente vaya acumulando patrones de simplificación en un archivo propio (por ejemplo ~/.claude/agents/learnings/refactor-agent.md). Si al usuario no le interesa esa memoria manual, déjalo tal cual o borra esa sección: 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: sonnet. Cámbiala si prefiere otro modelo para este agente.
• Rama base — el ejemplo usa git diff main...HEAD. Si el proyecto usa otra rama principal (por ejemplo master o develop), el agente la ajusta solo al leer el repositorio, pero puedes fijarla si el usuario lo pide.
• Herramientas de simplificación — el agente prefiere el skill oficial simplify; si el usuario tiene el plugin code-simplifier o superpowers, los aprovecha, y si no, aplica los principios él mismo.

¿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: refactor-agent, ya quedó sembrado.

Para probarlo de verdad, la próxima vez que tu asistente escriba o modifique código, dile algo como: "dale un refactor al código que acabas de escribir" o "esto quedó muy enredado, límpialo". Tu asistente invocará al refactor-agent, que simplificará solo lo último que tocaron, correrá las pruebas antes y después para asegurarse de no romper nada, y te entregará un commit limpio con el resumen de lo que cambió.

Nunca cambia el comportamiento de tu programa: solo lo deja más claro y más corto. La decisión de fusionar siempre es tuya.