# Instrucciones para el agente: FP&A Agent: revisa fórmulas y escenarios en Google Sheets

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/jeffgraySF/fpa-agent (licencia NOASSERTION)
- Guía completa: https://lab.wisd.ai/hub/fpa-agent

---

## 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: prepara el entorno

Comprueba que tienes Git, Python ≥3.11 con venv y pip, Node.js ≥18 y Claude Code instalado y autenticado. Los comandos de activación siguientes usan una shell de macOS o Linux.

```bash
git clone https://github.com/jeffgraySF/fpa-agent.git
cd fpa-agent
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
```

### Paso 2: configura Sheets

Sigue el apartado OAuth del README: habilita Sheets API, configura consentimiento y usuario de prueba y crea un cliente de escritorio. Guarda el JSON como `credentials.json` en la raíz de `fpa-agent`, sin versionarlo. La primera llamada abre el navegador para autorizar; el token queda en `~/.fpa-agent/token.json`.

### Paso 3: inicia Claude Code

```bash
claude
```

Dentro de Claude Code usa `/connect https://docs.google.com/spreadsheets/d/YOUR_SHEET_ID`, sustituyendo el ID por el de una copia de prueba. Ejecuta `/inspect Monthly Summary` con el nombre real de una pestaña, y `/explain Monthly!B15` con una celda que contenga una fórmula conocida; contrasta la explicación con esa celda.

## Comprobación

Comprueba que puedes explicar una fórmula y ejecutar un escenario sin alterar la hoja. Antes de probar `/modify`, revisa el plan y comprueba después las celdas afectadas.

## Si algo falla

Si OAuth muestra acceso bloqueado, revisa el usuario de prueba y el cliente de escritorio. Si el resultado parece incompleto, compara `/inspect` con el escaneo completo `/scan` descrito en el README.

Consulta el [README oficial](https://github.com/jeffgraySF/fpa-agent#readme) para el procedimiento completo y los cambios de versión.