🧱 Guardia y panel

En los videos que circularon sobre mods de Claude Code aparecieron dos protecciones: una guarda de colisión (dos agentes en el mismo archivo) y una de "radio de impacto" (el tamaño del daño que puede causar un comando que borra).

La idea es excelente. El kit crea su propia versión, solo con recursos oficiales: los hooks de Claude Code. La división es simple: la regla queda en el script, la pantalla queda en el mod.

Cómo leer el diagrama: la caja ámbar es el punto de control. Todas las ediciones y todos los comandos pasan por ahí antes de ejecutarse. Si no hay riesgo, sigue por la flecha azul. Si hay riesgo, el guardián no bloquea ni permite: te devuelve la pregunta (N2).

"PreToolUse": [
  {
    "matcher": "Edit|Write|MultiEdit|NotebookEdit",
    "hooks": [ { "type": "command",
      "command": "node \"$CLAUDE_PROJECT_DIR/runtime/mods/runtime-guarda/hooks/colisao.mjs\" pre",
      "timeout": 10 } ]
  },
  {
    "matcher": "Bash",
    "hooks": [ { "type": "command",
      "command": "node \"$CLAUDE_PROJECT_DIR/runtime/mods/runtime-guarda/hooks/raio.mjs\"",
      "timeout": 15 } ]
  }
]
…
"PostToolUse": [ … colisao.mjs pos … ]

El problema es real. Ocurrió en un proyecto nuestro: una sesión vació un archivo que otra estaba editando. Ninguna de las dos se equivocó por sí sola. Cada una creía que el archivo era solo suyo.

La colisión se resuelve con memoria. Después de cada edición, anota «esta sesión modificó este archivo ahora». Antes de la siguiente edición, comprueba la anotación y la fecha del archivo.

Cómo leer el diagrama: la flecha azul es la edición normal de la sesión A, que queda anotada. La flecha roja es la sesión B que llega dentro de la ventana de 30 minutos. Quien responde la pregunta del recuadro ámbar eres tú.

Probado en el CHANGELOG 0.3.0: con 5 casos (archivo antiguo, modificado desde fuera, misma sesión, otra sesión, inexistente), la colisión solo pregunta en los casos de otra sesión y de modificación desde fuera. Dentro de Claude, se bloqueó una edición de un archivo de otra sesión y el archivo quedó intacto.

O rayo va antes de un rm o git clean. Cuenta cuántos archivos existentes se borrarían, suma el tamaño y enumera las primeras rutas. Después pregunta: «¿Hay una copia de seguridad? Confirma para continuar.»

El rayo no borra nada: solo lee el disco. Y si el comando no borraría ningún archivo existente, no hace nada. Puedes probar el script por separado, sin abrir Claude, enviándole el mismo pedido que Claude enviaría.

mkdir -p /tmp/teste-raio/x && echo a > /tmp/teste-raio/x/a && cd /tmp/teste-raio
printf '{"cwd":"%s","tool_name":"Bash","tool_input":{"command":"rm -r x"}}' "$PWD" \
  | node /caminho/do/kit/runtime/mods/runtime-guarda/hooks/raio.mjs

a saída traz "permissionDecision":"ask"
e o texto Raio: este comando apaga 1 arquivo(s)

En la carpeta del kit, la protección ya está activada. Pero Sônia tiene otra carpeta, la de los cierres mensuales, donde también ejecuta agentes. Quiere la misma protección allí.

La receta R7 ofrece dos formas. Elige uno, no los dos.

claude --plugin-dir /caminho/do/kit/runtime/mods/runtime-guarda

com --plugin-dir runtime-guarda e o modo que libera tudo,
rm -r pasta foi barrado pelo "Raio" e a pasta ficou intacta;
Edit em arquivo editado por outra sessão foi barrado pela "colisão".

En el módulo 3.3, liberaste sesiones con claude --bg y lo siguió con observar.mjs, en otra terminal. El panel incluye esta lista en Claude Code. Es opcional.

Muestra cada sesión en segundo plano con nombre, estado y minutos, y un botón Actualizar y un botón Detener en las que están en ejecución. Solo tu clic para una sesión.

claude --plugin-dir runtime/mods/runtime-painel

claude plugin validate runtime/mods/runtime-painel
claude plugin test runtime/mods/runtime-painel

validate: passa
test: 1 pass

Cómo leer el diagrama: es una ilustración, no una captura de pantalla. La línea r4-revisor · done · 7 es la misma sesión que el observar.mjs mostró en el módulo 3.3. El botón rojo solo aparece en sesiones que todavía están en ejecución.

Qué revisar en la tabla: ambos leen la misma lista de sesiones. Elige según tu comodidad, no por la función.

Los mods y plugins se ejecutan con los mismos permisos de Claude Code. Un hook puede leer tus archivos, ejecutar comandos y acceder a la red sin preguntar. Por eso protege bien y por eso un mod malintencionado puede causar mucho daño.

La regla de la receta R7: lee el código de cualquier mod de terceros antes de instalarlo. No necesitas programar para esto. Pídele al agente que lea y explique, sin ejecutar nada.

Lee runtime/mods/runtime-guarda/.claude-plugin/plugin.json, runtime/mods/runtime-guarda/hooks/hooks.json, colisao.mjs y raio.mjs. Dime en lenguaje sencillo: en qué momento se ejecuta cada hook, qué lee, qué escribe y si accede a la red. No instales ni ejecutes nada.