# Instrucciones para el agente: Hookify: define reglas para las herramientas de Claude Code

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/anthropics/claude-plugins-official/tree/main/plugins/hookify (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/hookify

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: instala el plugin desde su catálogo

Comprueba con `python3 --version` que tienes Python ≥3.7. En `/plugin` de Claude Code, confirma que el catálogo oficial está registrado; si falta, regístralo desde la pestaña Marketplaces de `/plugin` con `anthropics/claude-plugins-official`. Después localiza Hookify e instálalo.

### Paso 2: crea una regla de prueba

El ejemplo oficial evita mensajes de depuración:

```text
/hookify No uses console.log en archivos TypeScript
/hookify:list
```

Inspecciona el archivo creado en `.claude/`: evento, patrón, estado y acción. Para cambiar su activación usa `/hookify:configure`.

## Comprobación

En un archivo de prueba provoca una coincidencia con `console.log` y confirma el aviso. Para comprobar también el bloqueo prometido, crea `.claude/hookify.prueba.local.md` con esta adaptación de la regla Bash del README; utiliza un marcador inocuo en lugar del patrón de borrado:

```markdown
---
name: prueba-bloqueo
enabled: true
event: bash
pattern: HOOKIFY_R2_BLOCK_TEST
action: block
---

Este comando está bloqueado por la regla de prueba.
```

Pide al agente que intente ejecutar `echo HOOKIFY_R2_BLOCK_TEST` mediante su herramienta Bash. Debe aparecer la denegación y el comando no debe ejecutarse. Un `echo` con otro texto debe seguir funcionando. Desactiva después esta regla de prueba con `/hookify:configure`. La acción predeterminada `warn` solo avisa: no basta para dar el bloqueo por comprobado.

## Si algo falla

Si no se dispara, revisa ubicación del archivo, `enabled`, evento y patrón. Si faltan importaciones, verifica Python y la instalación del plugin. La guía indica que las reglas se aplican sin reinicio.