Sube los siete escalones de la escalera
Una vía es la vía por la que el agente accede a un sistema: pedir datos, leer un archivo, hacer clic en una pantalla. El runtime/LEIA-ME.md organiza las vías en una escalera de siete niveles.
Empiezas por el nivel 1 y vas bajando hasta encontrar la primera vía que existe y funciona. La frase del kit: usa la más alta que exista.
🆕 ¿Eres nuevo aquí? Las palabras de la escalera
- API — la puerta oficial que un sistema abre para que otros programas soliciten datos. Ej.: «dame las ventas de octubre».
- MCP — un estándar para proporcionar herramientas a los agentes. Un servidor MCP dice "tengo la herramienta X" y el agente empieza a llamarla por su nombre.
- CLI — programa que se usa con comandos en la terminal, como
codex execogit. - SDK — una biblioteca ya preparada (paquete npm o pip) que un programador usa para comunicarse con el sistema.
- Puente local — usar lo que el sistema permite en tu computadora: una exportación CSV, una carpeta, una base de datos SQLite, un puerto local.
Cómo leer el diagrama: el número indica el orden en que haces las pruebas. El color representa la estabilidad: verde es alta, azul es media, rojo es baja. Fíjate en que el 6 es azul y el 5 es rojo: estar más abajo no significa ser peor. El tema 2 lo explica.
| Nivel | Vía | Ejemplo | Estabilidad |
|---|---|---|---|
| 1 | API oficial | API del ERP | alta |
| 2 | MCP | claude mcp list | alta |
| 3 | CLI | codex exec, gh, git | alta |
| 4 | SDK / biblioteca | paquete npm/pip | media |
| 5 | Uso de la computadora | navegador automatizado, clics en la pantalla | descarga |
| 6 | Puente local | exportación CSV, carpeta, base de datos SQLite, puerto local | media |
| 7 | Ingeniería inversa | observar la aplicación en ejecución para encontrar la vía | solo laboratorio: se rompe en la siguiente actualización |
Qué revisar en la tabla: es la tabla del runtime/LEIA-ME.md, sin cambiar una palabra. La columna "Ejemplo" muestra el tipo de cosa que hay en cada nivel; no necesitas ejecutar estos ejemplos ahora.
ruta hasta el sistema
orden de la prueba
los tres firmes
archivo exportado
Entiende por qué la estabilidad es lo más importante
Estabilidad es cuánto sigue funcionando una vía cuando el otro lado cambia. Una API tiene un contrato: el fabricante avisa antes de hacer cambios. En la pantalla de un sitio, mueven un botón y el robot que hacía clic allí se pierde.
El README del kit cierra la idea: el agente usa siempre la más estable que exista. Por eso el puente local (6, media) supera el uso del computador (5, baja) cuando existen ambas opciones. La receta R5 dice lo mismo: usa el navegador solo cuando no exista una API, MCP, CLI o exportación.
✓ Vía estable
- ✓ Hay un contrato: el fabricante mantiene
- ✓ El cambio llega con aviso y versión
- ✓ Lo configuras una vez y te olvidas
- ✓ El error, cuando aparece, es claro
✗ Vía frágil
- ✗ Depende de dónde esté el botón en la pantalla
- ✗ Se rompe sin aviso, en una actualización
- ✗ Pide una reparación todas las semanas
- ✗ A veces falla en silencio
💡 El costo real está en el mantenimiento
La vía estable a veces requiere más trabajo el primer día: encontrar la exportación, configurar el puente. Pero lo que cuenta es el mes siguiente. La vía que menos se rompe es la que cuesta menos mantener.
¿soporta cambios?
el fabricante mantiene
el costo del mes siguiente
se interrumpe sin aviso
Exige una prueba antes de decir «no se puede»
El agente dice «no se puede» demasiado pronto. No encontró documentación y concluye que no existe. El kit tiene una regla contra eso, escrita en el LEIA-ME.md y repetida en el AGENTS.md.
La regla: antes de concluir que algo es imposible, el agente prueba cada nivel con un comando. “No encontré” no sirve. Sirve “ejecuté esto y salió esto”.
Regla: si el agente dice "no se puede", pídele que **pruebe** cada nivel con un comando antes de concluir. Muchas veces la vía existe y solo faltaba documentarla.
runtime/LEIA-ME.md. O AGENTS.md pide al agente que lo haga por su cuenta.Cómo leer el diagrama: el lazo rojo vuelve a la izquierda con el siguiente escalón. Cada vuelta deja una evidencia anotada. Un «no se puede» honesto viene con esa lista; un «no se puede» sin lista es una suposición.
⚠️ El «imposible» prematuro cuesta caro
El agente que no encontró documentación tiende a decir que no se puede leer el programa desde fuera. Muchas veces, la prueba nivel por nivel revela una opción de exportación oculta en un menú. Si aceptas el primer "no se puede", recurres a una solución improvisada sin necesidad.
"no lo encontré" ≠ "no existe"
un comando por nivel
la salida en pantalla
la regla ya está ahí
Sube la escalera con el ERP de Sônia
Sonia quiere el total de ventas por cliente de la distribuidora. El ERP es antiguo: no tiene API. Lo que sí sabe hacer es exportar un CSV de ventas, o runtime/exemplos/erp-vendas.csv del kit.
Mira la escalera peldaño por peldaño. Es el caso más común en una oficina pequeña: un sistema antiguo que solo exporta archivos.
| Nivel | ¿Existe para el ERP? | Decisión |
|---|---|---|
| 1 · API | no: el fabricante no lo ofrece | baja |
| 2 · MCP | no hay servidor MCP del ERP | baja |
| 3 · CLI | no tiene comando de terminal | baja |
| 4 · SDK | no tiene biblioteca | baja |
| 5 · computadora | se podría hacer clic en las pantallas… | existe, pero es baja: guárdala y mira la siguiente |
| 6 · puente local | sí: exporta el CSV de ventas | detente aquí: el promedio supera al mínimo |
Qué revisar en la tabla: en el nivel 5 la respuesta es "existe", y aun así la escalera continúa. Es la regla del tema 2: R5 solo acepta el navegador cuando no hay exportación, y aquí sí la hay.
Cómo leer el diagrama: la línea de arriba es el camino elegido: el ERP libera el archivo y el puente entrega una herramienta lista. La caja roja tachada de abajo es el camino descartado. En la ruta 2 (receta R3), ese puente se convierte en una herramienta MCP real.
lo que ya hace el ERP
erp-vendas.csv
nivel 6, promedio
N4: lee sin pedir
Sube la escalera con la agenda de Clara
La agenda de la clínica de Clara es una hoja de cálculo. Una hoja de cálculo no tiene API, MCP, CLI ni SDK: es un archivo. Así que la escalera baja hasta la puente local, igual que la de Sônia. En el kit, ella es el runtime/exemplos/agenda.csv, con los horarios de la Dra. Ana y el Dr. Bruno.
La diferencia aparece después. Sonia solo quiere leer. Clara, algún día, querrá que el agente marca un horario. Y la misma vía puede tener políticas diferentes para leer y modificar.
🆕 ¿Eres nuevo aquí? N2 y N4
Son niveles de autonomía de runtime/POLITICA.md. N4: el agente lo hace por su cuenta, sin avisar (sirve para leer). N2: el agente ejecuta solo después de preguntar, cada vez. La escala completa, de N0 a N4, está en el módulo 4.1.
✓ Leer la agenda (N4)
- ✓ «¿Qué horarios están disponibles el día 7?»
- ✓ El agente lee el archivo y responde
- ✓ Nada cambia en la hoja de cálculo
- ✓ Puede ejecutarse sin preguntar
✗ Cambiar la agenda sin preguntar
- ✗ Agendar al paciente por cuenta propia
- ✗ Cambiar «libre» por «ocupado» sin aviso
- ✗ Un error se convierte en un paciente sin turno
- ✗ Por eso, cambiar queda en N2: pregunta antes
| Agenda da clínica (planilha) | Ponte local (arquivo) | 6 | ler/escrever agenda.csv | alterar (N2) | pendente |
💡 Consejo para Clara
Empieza solo con lectura. Cuando confíes en las respuestas sobre los horarios disponibles, agrega la escritura, siempre pidiendo confirmación antes. Es el mismo archivo; lo que cambia es la política.
Dra. Ana y Dr. Bruno
N4
N2, pide antes
políticas diferentes
Sube la escalera con tu sistema
Ahora te toca a ti. Elige uno sistema de tu trabajo: el programa de la tienda, el portal del proveedor, la hoja de cálculo del inventario. Pídele al agente que suba la escalera contigo, probando cada nivel.
El prompt de abajo usa solo archivos del kit. Pide la prueba por nivel y prohíbe modificar el sistema: en esta etapa, el agente solo explora.
Abre claude en la carpeta del kit y pega (cambia lo que está entre < >):
Leia runtime/LEIA-ME.md. Quero conectar o <nome do sistema>, que eu uso para <o que você faz nele>. Suba a escada das vias comigo, um nível por vez. Em cada nível, me diga como testar com um comando, mostre o resultado e só então passe ao próximo. Não conclua "não dá" sem testar todos. Não altere nada no sistema. No fim, me diga qual é a via mais estável que existe e por quê.
Un sistema a la vez
Mezclar tres sistemas en una solicitud confunde las evidencias. Haz uno, toma nota y pasa al siguiente.
Responde lo que solo tú sabes
El agente puede preguntar si hay un menú "exportar" o un sitio de integraciones. Revisa el programa y cuéntale.
Guarda la elección
La vía que salga de aquí se convierte en una línea de CAPACIDADES.md en el próximo módulo, y la base de tu proyecto final.
Prueba rápida (opcional): el ERP de Sônia se puede operar desde la pantalla (nivel 5) y también exporta CSV (nivel 6). ¿Qué vía usar?
por pedido
nivel por nivel
en cada nivel
la más estable
🎓 Resumen del módulo
Próximo módulo:
1.4 — El mapa de capacidades