# Instrucciones para el agente: Fast Jev Compaction: recorta historial de herramientas en 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: avanzado
- Proyecto: https://github.com/tamaratran/fast-jev-compaction (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/fast-jev-compaction

---

## 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: comprueba la interfaz de hooks

Lee el [README del hook](https://github.com/tamaratran/fast-jev-compaction/blob/e3f262a7f4d42bd8dd32ced30d26176f7cb545b0/hooks/README.md). La referencia del proyecto es Claude Code 2.1.274 con function hooks de acceso anticipado. No asumas compatibilidad con cualquier versión que admita plugins.

### Paso 2: habilita la función y prepara la clave

El hook documenta estas variables:

```sh
export CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1
export TYPESAFE_API_KEY="<your TypeSafe key>"
```

El segundo valor es un marcador que debes sustituir en tu entorno privado. No lo copies al chat ni a archivos versionados. Antes de una prueba en vivo, ten en cuenta que el estado de conversación se envía a TypeSafe y genera consumo.

### Paso 3: instala el plugin

Desde el mismo entorno:

```sh
claude plugin marketplace add tamaratran/fast-jev-compaction
claude plugin install fast-jev-compaction@fast-jev-compaction
```

Conserva inicialmente las opciones predeterminadas. Reinicia Claude Code o ejecuta `/reload-plugins`, como indica el README principal.

### Paso 4: prueba la compactación

En una sesión de prueba con varias lecturas de herramientas, utiliza `/compact`. El plugin también participa en la compactación automática. No construyas la primera prueba con datos confidenciales.

## Comprobación

Observa el aviso: `kept N/M messages, no summary` indica que se aplicó la poda; `fallback to built-in summary` indica el retorno al resumen integrado. Una sesión demasiado corta puede producir ese retorno sin que exista un error de instalación.

Comprueba que las instrucciones textuales siguen presentes y revisa el registro de decisiones de las herramientas. No interpretes una salida eliminada como memoria conservada.

## Si algo falla

Comprueba que Claude Code heredó las variables, que la versión admite la interfaz y que la clave tiene acceso al servicio. El hook documenta errores de API, respuesta inválida, falta de espacio y reducción insuficiente como motivos de retorno al resumen. Revisa el registro antes de modificar umbrales o límites.