# Instrucciones para el agente: numasec: agente de terminal para auditorías con evidencias

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/FrancescoStabile/numasec (licencia AGPL-3.0)
- Guía completa: https://lab.wisd.ai/hub/numasec

---

## 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: elige un laboratorio y un proveedor

Comprueba que Node.js y npm están disponibles en la terminal. Define el objetivo autorizado y prepara acceso al modelo conforme al [README](https://github.com/FrancescoStabile/numasec). No incluyas claves en el informe ni en el historial que vayas a compartir.

### Paso 2: instala la CLI

La vía npm del README es:

```bash
npm install -g numasec
numasec
```

Sigue la configuración de modelos que muestra la aplicación.

### Paso 3: inspecciona el entorno

Dentro de numasec, los comandos documentados incluyen:

```text
/doctor
/models
/mode appsec
/runbook list
```

Comprueba qué herramientas existen antes de elegir un runbook. Revisa alcance y autonomía en la operación antes de ejecutar acciones sobre el objetivo.

## Comprobación

Usa una revisión pequeña de laboratorio. Comprueba que las observaciones enlazan evidencia y que el reporte distingue lo observado de las hipótesis. Verifica que puedes retomar la operación desde `/operations`, comando documentado en el README.

## Si algo falla

Vuelve a `/doctor` para identificar dependencias faltantes y revisa `/models` si falla el proveedor. No amplíes el alcance para conseguir un resultado. Si una herramienta devuelve un error, consérvalo como tal y consulta su documentación antes de tratarlo como una vulnerabilidad.