# AGENTE.md · Instrucciones para el asistente de IA
**Equipo __ · Proyecto __**
Versión de este archivo: __ · Fecha: AAAA-MM-DD · Quién aprueba cambios al modelo: __

> Este archivo se le entrega al asistente **al empezar cada sesión de trabajo**. No es un informe:
> es el contrato con el que trabaja la herramienta. Si el asistente hace algo que este archivo no
> autoriza, el error es del archivo, y se corrige aquí.

---

## 1 · Alcance — qué manda y qué no

| | |
|---|---|
| **Archivo vivo (fuente de verdad)** | `modelo-financiero.xlsx` — es el único que se edita |
| **Archivos congelados** | los de `entregas/` — no se tocan nunca, son el registro de lo ya entregado |
| **Hojas que el asistente puede editar** | __ |
| **Hojas que NO puede tocar** | `Supuestos` (ver regla 1), y __ |
| **Documentos que manda este archivo** | __ |
| **Qué NO cubre** | __ (lo cubre `__.md`) |

**Cuándo se invoca:** antes de tocar cualquier hoja del modelo, antes de reportar cualquier cifra en
la ficha, la nota de inversión o la presentación, y antes de cada auditoría cruzada.

---

## 2 · Las reglas que este agente no rompe

**Del modelo** (las seis del `LÉEME`):

1. Ningún número escrito dentro de una fórmula. Todo supuesto vive en `Supuestos`.
2. Toda celda numérica lleva su **unidad** en el encabezado. `USD/ha`, no `Costo`.
3. Toda cifra externa lleva su **fuente**.
4. Nominal con nominal, real con real. **Este modelo está en __ y por lo tanto se descuenta a
   tasas __.**
5. La deuda aparece **una** vez: en el numerador (FCA) o en el denominador (WACC). Nunca en las dos.
6. Riesgo específico → al flujo. Riesgo sistemático → a la tasa. **Nunca a los dos.**

**De la evaluación** (sesiones 3 y 4):

7. El impuesto es `MÁX(0; EBIT) × t`: cero en años de pérdida, nunca negativo.
8. El escudo fiscal sólo existe cuando hay renta gravable: `MÍN(intereses; MÁX(0; base gravable)) × t`.
9. El capital de trabajo se recupera en el último año.
10. Se cuentan los cambios de signo **antes** de reportar la TIR, y se reporta la **TIRM** al lado,
    con las dos tasas declaradas.
11. Cuando un criterio contradice al VPN, gana el VPN.
12. El riesgo climático entra **una sola vez**: o en el flujo o en la tasa.

**De la gobernanza:**

13. **La IA propone; la fuente primaria decide.** Ninguna cifra entra a `Supuestos` sin fuente.
14. Ninguna cifra sin fuente se presenta como dato: se marca `[sin verificar]` y se dice en voz alta.
15. **No se reportan VPN, TIR ni conclusiones definitivas mientras haya un hallazgo estructural
    abierto** (§6).
16. Lo que el asistente escribió en el Excel queda marcado (comentario en la celda) hasta que el
    equipo lo verifique.
17. Todo cambio queda registrado en `MEMORIA.md` el mismo día.

---

## 3 · El estado de cada cifra

Toda cifra del modelo está en uno de estos cuatro estados, y el estado se escribe al lado del dato:

| Estado | Qué significa | Puede entrar a `Supuestos` |
|---|---|:-:|
| `VERIFICADO` | Contrastada contra la fuente primaria, con fecha de consulta | sí |
| `ESTIMADO` | Construida por el equipo con un método declarado | sí, con el método escrito |
| `[sin verificar]` | Propuesta por la IA o por alguien, sin contraste todavía | **no** |
| `[dato faltante]` | Se buscó y no se encontró | **no** — y un cero de "no encontrado" no es un cero verificado |

---

## 4 · Decisiones

**Tomadas** — el asistente no las revisa ni las cambia sin autorización:

| Id | Decisión | Por qué | Fecha |
|---|---|---|---|
| D-01 | __ | __ | __ |

**Pendientes** — el asistente **no puede resolverlas por su cuenta**; si el trabajo depende de una,
se detiene y pregunta:

| Id | Qué hay que decidir | Quién decide | Para cuándo | Valor provisional |
|---|---|---|---|---|
| D-__ | __ | __ | __ | __ |

---

## 5 · Mapa del modelo — qué calcula cada hoja y con qué tasa

| Hoja | Qué calcula | De dónde viene | Tasa que le corresponde |
|---|---|---|---|
| `Supuestos` | Fuente única de todos los parámetros | inputs con fuente | — |
| `CapEx` / `OpEx` / `KTrabajo` | Inversión, operación, capital de trabajo | `Supuestos` | — |
| `FCLD` | ¿Es buena la **idea**? Sin deuda | `KTrabajo`, `CapEx` | **WACC** __ |
| `FCA` | ¿Le sirve al **dueño**? Con deuda | `FCLD` + tabla de amortización | **Ke** __ |
| `FlujoSocial` | ¿Le sirve al **país**? | `FCLD` sin transferencias | **TSD** __ |
| `Criterios` | Las cinco lecturas del flujo | `FCLD`, `FCA` | — |

---

## 6 · Checklist de salida — antes de reportar cualquier cifra

**(a) Los ítems de la auditoría de la sesión.** Para cada uno: cumple / no cumple, **la celda que lo
prueba**, y qué corregir. La regla que lo hace honesto: **si el veredicto depende del juicio de
quien audita y no de una celda, el veredicto por defecto es NO CUMPLE.**

| # | Ítem | Veredicto | Celda que lo prueba |
|---:|---|---|---|
| 1 | __ | __ | __ |

**(b) La prueba de sensatez.** Toda cifra de salida se divide por algo conocido antes de creerle:

- [ ] Capital de trabajo ÷ CapEx → ¿entre 0,2 y 1,5?
- [ ] Ingreso del primer año ÷ CapEx ejecutado a esa fecha → ¿tiene sentido?
- [ ] VPN ÷ inversión total → ¿es un porcentaje creíble, o es cero disfrazado?
- [ ] Área sembrada total ÷ área del proyecto → ¿cabe? (si hay asocio, declararlo)
- [ ] __

**(c) La entrega.** **El archivo que se entrega es el que se abrió y se recalculó.**

- [ ] Si el libro lo escribió un script, abrirlo, recalcular (`Ctrl + Alt + F9`) y guardarlo desde
      la hoja de cálculo. Un archivo sin valores calculados no es un modelo: es una hipótesis.
- [ ] Cero errores `#¡REF!` `#¡DIV/0!` `#N/A` `#¿NOMBRE?` en todas las hojas.
- [ ] Las funciones modernas (`LET`, `LAMBDA`, `XLOOKUP`) no sobreviven a un archivo escrito por
      script: usar funciones clásicas.
- [ ] Los números del documento coinciden con los del modelo. **En un texto generado, o todo se
      calcula, o nada** — una frase con cifras vivas y adjetivos fijos miente sin que se note.

---

## 7 · Lo que este agente NO hace, a propósito

- No inventa supuestos, precios, cronogramas ni fuentes. Si no encuentra un dato, lo marca
  `[dato faltante]`.
- No reconstruye el modelo desde cero: audita primero lo que existe.
- No sube el WACC "por el riesgo del proyecto": el riesgo específico va al flujo (regla 6).
- No mueve dos variables a la vez y lo llama análisis univariado.
- No cita una fuente que no pudo abrir; declara que no pudo abrirla.
- __

---

## 8 · Qué queda registrado

Cada sesión de trabajo escribe en `MEMORIA.md`: fecha, herramienta, para qué, prompt, qué propuso,
qué se verificó y contra qué, qué cambió el equipo. Este archivo dice **cómo se trabaja**;
`MEMORIA.md` dice **qué pasó**.