# Instrucciones para el agente: Slashbooks: lleva libros locales con ayuda de tu agente

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/giltotherescue/slashbooks (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/slashbooks

---

## 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 de Claude Code

Comprueba Python 3.11 o posterior y lee el README. En Claude Code, el recorrido oficial es:

```sh
/plugin marketplace add https://github.com/giltotherescue/slashbooks
/plugin install slashbooks@slashbooks
```

Para Codex y Cowork sigue sus apartados propios del README.

### Paso 2: prepara el comando books

El plugin aporta las instrucciones; para ejecutar los comandos de terminal siguientes, instala también la CLI. Comprueba Git y pip en un entorno Python ≥3.11 separado. El recorrido oficial desde código es:

```sh
git clone https://github.com/giltotherescue/slashbooks slashbooks
cd slashbooks
pip install -e '.[xlsx]'
```

### Paso 3: prueba con la demostración

Una instalación con el CLI disponible puede usar el ejemplo oficial:

```sh
books demo init ~/Documents/books/northstar-demo
cd ~/Documents/books/northstar-demo
books queue list --entity .
```

No apuntes el ejemplo a los libros reales de otra empresa.

### Paso 4: prepara una comparación

En el agente usa `/books` y elige el procedimiento adecuado. Para evaluar una migración, sigue `/books-backtest` con copias de las exportaciones y revisa las diferencias antes de cerrar un periodo real.

## Comprobación

Comprueba que la demostración crea su propia carpeta y muestra la cola. En una comparación real, contrasta saldos y movimientos con sus fuentes; un comando sin errores no valida la contabilidad.

## Si algo falla

Si el CLI no aparece, revisa el runtime Python y el método de instalación del cliente. Si hay diferencias en la comparación, revisa importación, fechas y asignaciones antes de aceptar el cierre. No ajustes las fuentes para hacer coincidir el resultado.

Fuente: [documentación del proyecto](https://github.com/giltotherescue/slashbooks/blob/c75e8cb5dde312b7fa4dc9dc18d74ce020fbfc01/README.md).