Micare

Seed Journal ·

Anatomía de una semilla: qué trae adentro y cómo pedirle a tu asistente que la siembre

Una semilla es una carpeta autocontenida que empaca una solución completa para que tu asistente AI (de inteligencia artificial) la instale por ti. Adentro trae cinco piezas: instrucciones de siembra, una ficha de presentación, una etiqueta técnica, los archivos de la solución y un historial de versiones. No necesitas entender ninguna. Para sembrarla, descargas la carpeta, la abres y le dices a tu asistente: «siembra esta semilla 🌱». Él lee las instrucciones, coloca cada archivo donde va y te avisa cuando quedó lista.

Por qué una carpeta y no un botón

Piensa en un sobre de semillas del vivero. Por fuera trae la foto de la planta que va a crecer y unas instrucciones cortas en la parte de atrás: dónde plantar, cada cuánto regar. Adentro están las semillas de verdad. Tú no eres botánico, pero con ese sobre en la mano cualquier jardinero sabe exactamente qué hacer.

Una semilla del Arsenal funciona igual. La solución técnica ya existe y ya fue probada; el reto era entregártela sin pedirte que la armes. Por eso viene como un paquete: todo lo necesario en un solo lugar, con una nota que tu asistente sabe leer. Tú traes la semilla, tu asistente hace de jardinero.

Qué trae adentro

Cuando abres la carpeta de una semilla ves cinco archivos. Solo uno te importa a ti; los otros cuatro son para tu asistente.

  • EMPIEZA-AQUI.md — las instrucciones de siembra. Es el único que tú necesitas notar. Contiene el paso a paso que tu asistente seguirá para instalar todo. Piénsalo como la nota pegada en el sobre.
  • README.md — la foto del paquete. Explica en lenguaje simple qué hace la semilla y qué molestia te quita. Lo lees si tienes curiosidad, no para instalar nada.
  • manifest.yaml — la etiqueta técnica, como el código de barras del sobre. Guarda datos como el nombre, la versión y en qué asistentes funciona. Sirve para el catálogo; a ti no te toca abrirlo.
  • kernel/ (núcleo) — las semillas de verdad. Es la carpeta con los archivos de la solución: el código, las reglas, los guiones. Tu asistente los coloca en el lugar correcto durante la siembra.
  • CHANGELOG.md — el historial de versiones, la bitácora de qué cambió en cada actualización.

Ese kernel cambia según el tipo de semilla que descargaste. Puede traer un skill (habilidad), un hook (gancho de automatización), un script o un flujo de trabajo (guion o workflow) o un agente. Da igual cuál sea: la anatomía de afuera es siempre la misma, así que sembrar cualquiera se siente idéntico. Si quieres entender qué distingue a cada tipo, mira qué es un skill y qué es un hook.

Cómo pedirle a tu asistente que la siembre

Aquí está lo bonito: no instalas nada tú. La instrucción cabe en una frase.

  1. Descarga la semilla y descomprime la carpeta si vino en un archivo .zip.
  2. Ábrela con tu asistente a la mano.
  3. Escríbele: «siembra esta semilla 🌱» (o «instala esta semilla»).

Tu asistente abre el EMPIEZA-AQUI.md, sigue los pasos, mueve los archivos del kernel a su sitio y te confirma cuando terminó. Si algo necesita tu permiso, te pregunta antes. Ese es todo el trabajo tuyo: traer la semilla y dar la orden.

Para que te hagas una idea de lo que puedes plantar, tres semillas del lote piloto: keep-awake, un guardián que evita que tu computadora se duerma mientras tu asistente trabaja; notificaciones-nativas, que te avisa con una alerta del sistema cuando el asistente necesita algo de ti; y git-secret-scan, que revisa que no se te escapen contraseñas antes de guardar cambios en un proyecto.

Da igual dónde vivas: Claude Code o Cowork

El flujo es el mismo en las dos casas donde puede vivir tu asistente. En Claude Code (la versión de terminal, esa pantalla de texto que parece de programador) le das la orden escribiendo. En Cowork (la versión de escritorio, con ventanas normales) haces lo mismo desde una conversación. Abrir la carpeta y decir «siembra esta semilla» funciona igual en ambas. Cada semilla indica en su etiqueta si es compatible con una, con otra o con las dos, y los pasos concretos están en instalar en Claude Code y instalar en Cowork.

Lo que ganas al entender esto

Saber qué trae una semilla te quita el miedo a instalarla. Ya no es una caja negra: es un sobre con una foto, unas instrucciones y las semillas adentro, y tú solo le pasas el sobre al jardinero. Con esa confianza puedes probar soluciones nuevas sin sentir que necesitas un manual de ingeniería para cada una.

Cuando tengas ganas de ver qué más se puede plantar, date una vuelta por El Arsenal y curiosea el catálogo. Cada semilla que te llame la atención se siembra con la misma frase que ya conoces.