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 invoca para diseñar la arquitectura de una funcionalidad antes de construirla. En vez de lanzarse a programar y descubrir los problemas a mitad del camino, primero entrega un plano: cómo se guardan los datos, cómo se comunica la aplicación, dónde están los riesgos y en qué orden conviene construir. Es la diferencia entre levantar una casa con planos o a puro tanteo.

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 (gancho de automatización) ni un script: se instala copiando un solo archivo Markdown a la carpeta de agentes del usuario. La plataforma lo descubre sola al leer esa carpeta. No lleva chmod y no se cablea en settings.json.

Paso 1 · Copiar el archivo del kernel

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

• Windows con Git Bash (Claude Code o Cowork):

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

  Estos comandos son de Git Bash (la terminal que viene con Git para Windows). En PowerShell o CMD la sintaxis es distinta; lo más sencillo es abrir Git Bash y pegarlos ahí, o pedirle al asistente que los adapte a tu terminal.

Sin permisos de ejecución 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-architect.md

Salida esperada:

name: code-architect

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-architect.md.

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

Paso 3 · Aterrizar el agente al proyecto (recomendado, opcional)

El kernel trae dos placeholders, ambos opcionales:

• <TU-STACK> / <TU-MODULO-A> / <TU-MODULO-B> — aparecen en una tabla de ejemplo dentro de la sección "Antes de diseñar: entiende el terreno". Si el usuario quiere que el agente respete decisiones de arquitectura fijas de su proyecto (por ejemplo "las integraciones externas van por adaptadores" o "en el cliente móvil está prohibida tal API"), ayúdalo a llenar esa tabla con sus módulos reales y déjala en el archivo de instrucciones de su repositorio (README, CLAUDE.md o AGENTS.md). Si no, el agente igual lee las convenciones del proyecto al arrancar; la tabla solo las fija por escrito.
• <TU-ARCHIVO-DE-APRENDIZAJES> — aparece solo en la sección "Mejora continua". Sirve si el usuario quiere que el agente acumule decisiones de arquitectura en un archivo propio (por ejemplo ~/.claude/agents/learnings/code-architect.md). Si no le interesa, déjalo tal cual o borra esa sección: el agente ya trae memory: project para memoria automática por proyecto.

Ajuste opcional que el usuario puede pedirte más adelante (edítalo dentro del .md): el modelo en la línea model: opus. Un modelo potente ayuda al razonamiento de arquitectura, pero puede cambiarse a uno más ligero si el usuario lo prefiere.

¿Cómo sé que funcionó?

Cuando tu asistente termine, pídele que corra la verificación del Paso 2 y te muestre el resultado. Si aparece name: code-architect, ya quedó sembrado.

Para probarlo de verdad, la próxima vez que estés por construir algo nuevo, dile a tu asistente algo como: "antes de codear, diséñame la arquitectura de [tu funcionalidad]" o "¿cómo estructuro [tal módulo]?". Tu asistente invocará al code-architect, que primero leerá cómo está armado tu proyecto, y luego te entregará un plano completo: el modelo de datos, cómo se comunica la aplicación, dónde están los riesgos, en qué orden construir y qué preguntas quedan abiertas. No escribe código: te da el plano para que tú (o tu asistente) construyan con rumbo claro. 🌱