Instrucciones para el asistente de IA

AGENTE.md · el archivo con el que trabaja la herramienta, entregable desde la S4

Copien AGENTE.md a la carpeta del equipo y llénenlo con su proyecto. Se sube con cada entrega desde la S4, junto al Excel y a la memoria del modelo. Se escribe antes de trabajar, no después.

Por qué existe

En la sesión 3 la mitad de los libros de Excel del curso no los escribió una persona: los escribió un script. Eso no es un problema — se espera que usen IA. El problema es otro, y apareció en tres formas distintas el mismo fin de semana:

  • Un modelo llegó sin un solo valor calculado: todas las fórmulas correctas, ningún resultado. Nadie lo había abierto.
  • Un archivo de análisis traía los veredictos “NO VIABLE” y “ALTAMENTE VIABLE” escritos a mano sobre VPN que la máquina nunca calculó.
  • Un equipo escribió un protocolo excelente cuya regla decía “no presentar VPN ni TIR mientras haya hallazgos estructurales abiertos”… y entregó VPN y TIR con el hallazgo abierto en su propio documento.

Ninguno de los tres es un error de finanzas. Los tres son errores de proceso: nadie corrió las reglas como paso final antes de entregar.

MEMORIA.md responde qué pasó. AGENTE.md responde cómo se trabaja: es el contrato que se le entrega a la herramienta al empezar cada sesión, y el checklist que se corre al terminar. Y es también la prueba, ante el comité de inversión, de que el equipo dirigió a la herramienta en vez de recibir lo que la herramienta quiso entregar.

Los dos archivos, y en qué se diferencian

AGENTE.md MEMORIA.md
Responde Cómo se trabaja Qué pasó
Mira hacia adelante — gobierna la próxima sesión atrás — registra la anterior
Se escribe antes de trabajar mientras se trabaja
Contiene alcance, reglas, decisiones pendientes, checklist de salida supuestos con fuente, decisiones tomadas, registro de prompts, hallazgos
Cambia poco: sólo cuando cambia una regla cada sesión

Son complementarios y los dos se entregan. Si se contradicen, manda AGENTE.md y se corrige la memoria.

Las cuatro reglas que lo hacen funcionar

  1. El archivo se le entrega al asistente al empezar, no se escribe al final. Un AGENTE.md redactado la noche antes de entregar es un informe, y ya existe uno: la memoria.
  2. Si el asistente hace algo que el archivo no autoriza, el error es del archivo. No se regaña a la herramienta: se escribe la regla que faltaba. Así el archivo mejora solo, sesión a sesión.
  3. El veredicto por defecto es NO CUMPLE. En el checklist de salida, un ítem sólo se marca cumplido si existe una celda que lo prueba. Si depende del juicio de quien audita, no cumple todavía.
  4. El archivo que se entrega es el que se abrió y se recalculó. Si el libro lo escribió un script, el último paso siempre es abrirlo, recalcular y guardarlo desde la hoja de cálculo. Un archivo sin valores calculados no es un modelo: es una hipótesis.

Qué contiene la plantilla

AGENTE.md trae ocho secciones. Ninguna es larga; todas son específicas de su proyecto:

§ Sección Para qué sirve
1 Alcance Cuál es el archivo vivo, cuáles están congelados, qué hojas puede tocar el asistente y cuáles no
2 Las reglas que no se rompen Las seis del modelo + las de la evaluación (impuesto, escudo fiscal, capital de trabajo, signos, riesgo una sola vez) + las de gobernanza
3 El estado de cada cifra VERIFICADO · ESTIMADO · [sin verificar] · [dato faltante] — y cuáles pueden entrar a Supuestos
4 Decisiones Las tomadas (que el asistente no revisa) y las pendientes (ante las que se detiene y pregunta)
5 Mapa del modelo Hoja por hoja: qué calcula, de dónde viene y con qué tasa se descuenta
6 Checklist de salida Los ítems de la auditoría con la celda que prueba cada uno, la prueba de sensatez y la regla de entrega
7 Lo que el agente NO hace Las tentaciones concretas: inventar fuentes, subir el WACC “por el riesgo”, mover dos variables y llamarlo univariado
8 Qué queda registrado El puente hacia MEMORIA.md
Tip

La sección 7 es la que más rinde. Escribir lo que la herramienta no debe hacer es más eficaz que describir lo que debe hacer, porque las fallas de una IA en un modelo financiero son predecibles: rellena huecos con cifras plausibles, prefiere la respuesta completa a la respuesta honesta, y no distingue entre “no encontré el dato” y “el dato es cero”.

Cómo se usa en la práctica

  1. Al empezar la sesión de trabajo: se le da el archivo completo al asistente y se le pide que confirme qué puede tocar y qué decisiones están pendientes.
  2. Durante: cada cifra que proponga entra marcada [sin verificar] hasta que alguien la contraste. Cada cambio se anota en MEMORIA.md.
  3. Antes de entregar: se corre la sección 6 completa — los ítems de la auditoría con su celda, la prueba de sensatez y el recálculo del archivo. Lo que no pase, se declara.

Cómo se evalúa

No se califica la extensión: se califica si el archivo gobierna de verdad.

  • Rúbrica R1, criterio “Trazabilidad de cifras”: que exista, que sea específico del proyecto (un AGENTE.md genérico no cuenta) y que sus reglas se vean cumplidas en el modelo.
  • Rúbrica R1, criterio “Respuesta a la auditoría previa”: que las decisiones pendientes y los hallazgos de la auditoría anterior aparezcan en las secciones 4 y 6, y que se cierren.
  • Rúbrica R3, modelo financiero final: el checklist de salida se compara contra el modelo entregado. Un ítem marcado CUMPLE que el modelo no cumple pesa más que un ítem marcado NO CUMPLE.
  • En el Investor Day el comité puede pedirlo. El equipo que pueda decir “la herramienta propuso esta beta, esta regla se lo impidió, y así se resolvió” gana la conversación.
Important

Un AGENTE.md que se marca todo en verde vale menos que uno con tres NO CUMPLE escritos por el propio equipo. El primero dice que nadie auditó; el segundo dice exactamente dónde está el riesgo — y eso es lo que un comité de inversión compra.