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. Vas a ver algunas palabras en inglés en la pantalla; ni caso, tu asistente te guía.

Esta semilla instala un agente (subagente): un ayudante especializado que tu asistente puede invocar para revisar tu código antes de fusionarlo. Antes de opinar, lee las reglas de tu repositorio y los aprendizajes de tu equipo; después reporta solo los problemas de los que está razonablemente seguro, los ordena por gravedad y te da un veredicto claro de si conviene fusionar o no, siempre citando el archivo y la línea exactos.

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. No lleva chmod, no lleva entrada en settings.json y no ejecuta ningún programa.

Paso 1 · Copiar el archivo del kernel

El kernel es un solo archivo: kernel/code-reviewer.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/code-reviewer.md ~/.claude/agents/code-reviewer.md
  

• Windows (Claude Code o Cowork):

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

Salida esperada:

name: code-reviewer

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 code-reviewer.md.

Como comprobación adicional en una sesión interactiva de Claude Code, el comando /agents debe listar code-reviewer 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 "Registro de aprendizajes conocidos" y "Mejora continua". Es el archivo donde el equipo anota las lecciones de errores pasados (por ejemplo ~/.claude/agents/learnings/code-reviewer.md) para que el reviewer las convierta en reglas y no deje pasar 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: sonnet. El valor por defecto funciona para todos; si el usuario quiere revisiones más profundas y tiene acceso a un modelo más potente (por ejemplo opus), cambia esa línea.
• Rama base — los ejemplos usan git diff main...HEAD. Si el proyecto usa otra rama principal (master, develop), el agente la ajusta solo al leer el repositorio; puedes fijarla si el usuario lo pide.
• Herramientas de orquestación — el agente aprovecha, si están instalados, un skill oficial de revisión de código (code-review) y los skills superpowers:requesting-code-review / superpowers:receiving-code-review. Si no hay ninguno, aplica el protocolo él mismo. No necesitas instalar nada extra para que funcione.

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

Para probarlo de verdad, la próxima vez que termines una funcionalidad o abras un pull request, dile a tu asistente algo como: "dale code review a este cambio antes de que lo fusione" o "revisa el diff del PR". Tu asistente invocará al code-reviewer, que primero leerá las reglas de tu repositorio, luego revisará solo lo que cambiaste, y te entregará un veredicto (aprobado, con comentarios, cambios requeridos o bloqueado) con cada hallazgo citando el archivo y la línea, y su nivel de confianza.

Lo que NO va a hacer: ahogarte en cien comentarios de "esto podría ser mejor". Solo te trae lo que de verdad importa. La decisión de fusionar siempre es tuya.