Also in English: rosmarops.com/blog/before-you-tell-your-agent-to-install-it/ · També en català: rosmarops.com/ca/blog/abans-de-dir-al-teu-agent-que-ho-instal-li/
Cada vez más herramientas de código abierto se instalan con una frase. Le dices a tu agente «instala esto de este repo» y lo hace. Es cómodo, y yo también lo hago. Pero lo que se instala no es solo un programa. Son instrucciones y código que tus agentes van a seguir.
Tomemos Kanvas. Es un tablero de tareas compartido entre tú y tus agentes de programación: los agentes lo actualizan y tú apruebas y revisas en el navegador. Es un buen proyecto, con licencia MIT y bien documentado, y precisamente por eso lo uso de ejemplo: dice con claridad qué deja. Lo que importa aquí es el patrón, no el proyecto.
Se instala diciéndole a tu agente que ejecute uvx kanvas-board init.
Qué deja en tu proyecto
- el tablero,
kanvas.json; - una skill en
.agents/skills/kanvas/, con su propiokanvas.py, que tus agentes ejecutan; - una copia de su
SKILL.mdpara Claude Code, en.claude/skills/kanvas/; - un
AGENTS.md, si no tenías.
Y fuera del proyecto
%LOCALAPPDATA%\Kanvas\boards.json, con los tableros que tienes abiertos y si están abiertos a otros dispositivos;- si lo eliges, una tarea programada que lo arranca al iniciar sesión;
- si lo eliges, tus tableros abiertos a tu red Tailscale sin contraseña. Su README lo dice claro: «anyone on your Tailscale network can open and edit your boards» (cualquiera de tu red Tailscale puede abrir y editar tus tableros).
Además, tiene un modo YOLO que puedes activar, en el que los agentes completan una cadena de tareas sin tu revisión, salvo la última.
Nada de esto está escondido: está todo en el README. La pregunta es si lo leíste antes de decir «instálalo».
Por qué importa
Lo que una herramienta instala para tus agentes (skills, instrucciones, scripts) es código e instrucciones que tus agentes van a seguir. Quien pueda reescribirlo dirige a tus agentes.
No es un fallo de una herramienta. Es lo que es una skill. Y por eso la pregunta antes de instalar no es solo «¿es bueno este proyecto?», sino también «¿qué van a leer y ejecutar mis agentes a partir de ahora, y quién más puede cambiarlo?».
Antes de decir «instálalo»
- ¿Qué ficheros escribe en tu proyecto, y cuáles van a leer o ejecutar tus agentes?
- ¿Qué deja fuera del proyecto: ajustes, tareas programadas?
- ¿Se abre algo a la red, y quién puede llegar?
- ¿Hay algún modo en el que los agentes actúan sin tu revisión?
Qué ve RosmarOps
Hoy RosmarOps ve AGENTS.md y las tareas programadas nuevas. Las skills, y Kanvas en sí, llegarán en una próxima versión.
Lo he escrito con asistentes de IA. La máquina, los hallazgos y la decisión de publicarlo son míos.