També en anglès: rosmarops.com/blog/before-you-tell-your-agent-to-install-it/ · en castellà: rosmarops.com/es/blog/antes-de-decirle-a-tu-agente-que-lo-instale/
Cada cop més eines de codi obert s’instal·len amb una frase. Dius al teu agent «instal·la això d’aquest repo» i ho fa. És còmode, i jo també ho faig. Però el que s’instal·la no és només un programa. Són instruccions i codi que els teus agents seguiran.
Prenem Kanvas. És un tauler de tasques compartit entre tu i els teus agents de programació: els agents l’actualitzen i tu aproves i revises al navegador. És un bon projecte, amb llicència MIT i ben documentat, i justament per això el faig servir d’exemple: diu amb claredat què deixa. El que importa aquí és el patró, no el projecte.
S’instal·la dient al teu agent que executi uvx kanvas-board init.
Què deixa al teu projecte
- el tauler,
kanvas.json; - una skill a
.agents/skills/kanvas/, amb el seu propikanvas.py, que els teus agents executen; - una còpia del seu
SKILL.mdper a Claude Code, a.claude/skills/kanvas/; - un
AGENTS.md, si no en tenies.
I fora del projecte
%LOCALAPPDATA%\Kanvas\boards.json, amb els taulers que tens oberts i si estan oberts a altres dispositius;- si ho tries, una tasca programada que l’arrenca en iniciar la sessió;
- si ho tries, els teus taulers oberts a la teva xarxa Tailscale sense contrasenya. El seu README ho diu clar: «anyone on your Tailscale network can open and edit your boards» (qualsevol de la teva xarxa Tailscale pot obrir i editar els teus taulers).
A més, té un mode YOLO que pots activar, en què els agents completen una cadena de tasques sense la teva revisió, excepte l’última.
Res d’això no està amagat: tot és al README. La pregunta és si el vas llegir abans de dir «instal·la-ho».
Per què importa
El que una eina instal·la per als teus agents (skills, instruccions, scripts) és codi i instruccions que els teus agents seguiran. Qui ho pugui reescriure dirigeix els teus agents.
No és un defecte d’una eina. És el que és una skill. I per això la pregunta abans d’instal·lar no és només «és bo aquest projecte?», sinó també «què llegiran i executaran els meus agents a partir d’ara, i qui més ho pot canviar?».
Abans de dir «instal·la-ho»
- Quins fitxers escriu al teu projecte, i quins llegiran o executaran els teus agents?
- Què deixa fora del projecte: ajustos, tasques programades?
- S’obre alguna cosa a la xarxa, i qui hi pot arribar?
- Hi ha algun mode en què els agents actuen sense la teva revisió?
Què veu RosmarOps
Avui RosmarOps veu AGENTS.md i les tasques programades noves. Les skills, i Kanvas mateix, arribaran en una propera versió.
Ho he escrit amb assistents d’IA. La màquina, els avisos i la decisió de publicar-ho són meus.