Lee las columnas de CAPACIDADES.md
En el módulo 1.3 descubriste el medio de cada sistema. El mapa de capacidades es donde queda escrita esa información, en un formato que el agente lee antes de actuar. El AGENTS.md indica: usa solo los sistemas enumerados allí, por la vía indicada.
Cada línea tiene seis columnas. Cada columna responde una pregunta que te harías antes de dejar que alguien use tu sistema.
Cómo leer el diagrama: lee de izquierda a derecha como una frase: "el sistema X, por la vía Y, en el nivel N, se llama así, tiene esta política y se probó en esta fecha". El recuadro verde es el que más pesa: sin él, la línea no cuenta.
| Columna | Pregunta | De dónde viene |
|---|---|---|
| Sistema | ¿Qué herramienta de tu trabajo? | tú |
| Vía | ¿Por dónde llega el agente a ella? | la escalera (1.3) |
| Nivel | ¿En qué nivel queda esta vía? | tabla del LEIA-ME.md |
| Cómo llama el agente | ¿Con qué comando o ruta? | la prueba que funcionó |
| Política | ¿Lo hace por su cuenta o pregunta antes? | POLITICA.md (leer, modificar, enviar…) |
| Probado en | ¿Cuándo lo verificó alguien? | la fecha de la prueba, o «pendiente» |
Qué revisar en la tabla: solo la primera columna depende únicamente de ti. Las demás salen de la escalera, de la política y de una prueba ejecutada.
lo que puede usar el agente
vienen de la escalera
viene de POLITICA.md
o «pendiente»
Entiende las dos líneas que ya vienen listas
El archivo no llega vacío. Incluye dos filas ya probadas: los propios agentes. Uno puede llamar al otro, y el mapa debe explicar cómo.
Usa estas dos como modelo de línea correcta: vía clara, nivel de la escalera, comando exacto, política y fecha.
| Sistema | Via | Nível | Como o agente chama | Política | Testado em | |---|---|---|---|---|---| | Codex CLI | CLI | 3 | `runtime/pontes/codex-exec.sh` | ler (N4) | 2026-10-05 ok | | Claude Code | CLI | 3 | `claude -p --permission-mode plan` | ler (N4) | 2026-10-05 ok |
🆕 ¿Eres nuevo aquí? Puente y modo de planificación
Puente es lo que convierte una vía en algo que el agente puede llamar. El codex-exec.sh es un puente: envuelve el codex exec con las reglas del kit (módulo 2.1). Modo de planificación (--permission-mode plan) es la forma de ejecutar Claude Code en la que solo lee y planifica, sin modificar nada. Por eso la línea de Claude cabe en «leer».
En la línea de Codex, Claude pide una segunda opinión a través del puente; modificar archivos con Codex es otra política, que activas solo cuando lo pidas (receta R1). En la línea de Claude, se lo invoca sin abrir la pantalla, en modo de planificación: lee y responde, sin cambiar nada.
✓ Qué las convierte en un buen modelo
- ✓ Comando exacto, que puedes copiar
- ✓ Nivel verificado en la escalera
- ✓ Política de solo lectura
- ✓ Fecha con "ok" de una prueba real
✗ Lo que tendría una fila incorrecta
- ✗ "usar Codex" sin decir cómo
- ✗ Nivel estimado al azar
- ✗ Política de «todo permitido»
- ✗ Ninguna fecha
CLI, estabilidad alta
sin pedirlo, no modificar
codex-exec.sh
2026-10-05 ok
Usa los ejemplos para copiar
Debajo de la tabla, el archivo incluye una sección «Ejemplos para copiar»: cuatro líneas para casos comunes. Fíjate en la última columna de todas: pendiente.
Pendiente quiere decir que la línea describe el plan, pero nadie lo ha probado todavía en tu máquina. Empezar con un ejemplo parecido a tu caso ahorra la mitad del trabajo.
| Planilha de estoque (.xlsx) | Ponte local (arquivo) | 6 | ler ~/estoque/estoque.xlsx | ler (N4) | pendente | | ERP sem API | Exportação CSV diária | 6 | ler ~/erp/export/*.csv | ler (N4) | pendente | | Agenda da clínica (planilha) | Ponte local (arquivo) | 6 | ler/escrever agenda.csv | alterar (N2) | pendente | | Site do fornecedor | Uso do computador | 5 | navegador automatizado | enviar (N2) | pendente |
| Ejemplo | Quién tiene este caso | Dónde se prueba el curso |
|---|---|---|
| Hoja de cálculo de inventario | tienda, depósito | 2.3 (puente de tu sistema) |
| ERP sin API | Sônia | 2.2 y 2.3 (receta R3) |
| Agenda de la clínica | Clara | 2.2 (receta R3) |
| Sitio del proveedor | quien compra a través del portal | 2.4 (receta R5) |
Qué revisar en la tabla: tres ejemplos se detienen en el nivel 6 y uno en el 5. El del sitio se queda en el 5 porque los sitios de proveedores suelen no tener exportación, y su política es "enviar" (N2), porque completar un formulario envía datos al exterior.
💡 La política sigue la acción más arriesgada
Inventario y ERP solo leen: N4. La agenda lee y escribe: se aplica el nivel más alto, «alterar» (N2). El sitio puede enviar: «enviar» (N2). Al copiar una línea, pregunta «¿qué es lo peor que puede hacer el agente por aquí?» y ajusta la política.
plan sin prueba
tres de los cuatro
solo el sitio
modificar y enviar requieren
Completa el mapa con el agente
El agente conoce la escalera; tú conoces tu trabajo. Juntos, el mapa queda listo en minutos. El README incluye el pedido listo, el mismo que usaste en el módulo 1.2.
O LEIA-ME.md da la pista sobre cómo guiar: pídele al agente que complete "conmigo, nivel por nivel". Es una entrevista guiada en la que tú apruebas cada línea.
Abre claude en la carpeta del kit y pega:
Lee runtime/LEIA-ME.md y ayúdame a completar CAPACIDADES.md para mi trabajo.
Si intenta hacerlo todo de una vez, complementa con:
Complétala conmigo, nivel por nivel: un sistema a la vez, una pregunta a la vez. Usa los ejemplos de CAPACIDADES.md como modelo y marca «pendente» en cada fila que todavía no hayamos probado.
runtime/CAPACIDADES.md. La nueva fila tiene las seis columnas completas y, en la última, “pendiente” o una fecha con el resultado de una prueba que viste ejecutarse.Tú dices el sistema
Con tus palabras: «la hoja de cálculo de la agenda», «el ERP que exporta ventas».
El agente sube la escalera
Pregunta y prueba nivel por nivel, como en el módulo 1.3, hasta encontrar la vía más estable.
Propone la línea
Vía, nivel, cómo llamar y política, con "pendiente" al final.
Tú revisas y apruebas
Verifica principalmente la política. Si tienes dudas, elige la más restrictiva.
💡 Sonia en diez minutos
Sonia dice: «ERP de la distribuidora, solo exporta CSV de ventas». El agente recorre la escalera, se detiene en el peldaño 6 y propone una fila a partir del ejemplo «ERP sin API», con la ruta de su carpeta de exportación y la política «leer (N4)». Ella la aprueba. Queda «pendiente» hasta que se ejecute el puente, en el módulo 2.3.
guiada por el agente
sistema y pregunta
punto de partida
tú apruebas
Deja pasar solo las líneas probadas
El archivo empieza y termina con la misma regla. En la parte superior: "solo se agrega una fila con prueba hecho". Al final: "sistema sin línea aquí no lo usa el agente".
Funciona como una lista blanca: lo que no está en la lista queda fuera. Esto impide que el agente invente acceso a un sistema que nadie verificó.
Cómo leer el diagrama: son dos puertas en secuencia. Solo llega a la caja verde quien pasa por ambas. Las cajas rojas no son un error: el agente obedece la regla y te devuelve la decisión.
✓ Línea que puede entrar
- ✓ Seis columnas completas
- ✓ Comando o ruta exactos en «cómo se llama»
- ✓ Política consultada en la
POLITICA.md - ✓ Fecha de una prueba que viste ejecutarse
✗ Fila que queda afuera (o pendiente)
- ✗ "Creo que hay una API" sin probarlo
- ✗ Comando que nadie ejecutó
- ✗ Política en blanco
- ✗ Fecha copiada de otra fila
⚠️ El agente no se pone a prueba por palabra
Si el agente escribe "probado" en la línea, pídele que te muestre el comando y la salida. La fecha del mapa corresponde a una prueba que se hizo en pantalla, no a una que él "cree" que pasaría. Es la misma idea de prueba que en las recetas: comando → salida esperada.
fuera de la lista, fuera
visto en pantalla
de cuándo pasó
todavía no se usa
Explora el software antes de decir que es imposible
Antes de marcar un sistema como "sin vía", observa lo que el programa ya ofrece. Muchas exportaciones están en un menú que nadie abre. Muchas integraciones están en una página de configuración olvidada.
Explorar es la parte buena de la ingeniería inversa: encuentras el camino observando, sin conectar ningún cable improvisado. Y si después de explorar no hay ningún camino, eso también queda registrado.
Menús de exportación e informes
Busca «Exportar», «Guardar como», «Informes». Un CSV ya es un puente local (escalón 6).
Configuración e integraciones
Las pantallas con "Integraciones", "API", "Desarrolladores" o "Webhooks" apuntan a los niveles del 1 al 3.
Ayuda y sitio web del fabricante
La documentación suele enumerar lo que el programa intercambia con otros. Muéstrasela al agente y pídele que lo pruebe.
¿No lo encontraste? Anótalo en LIMITES.md
Qué intentaste, qué te bloqueó y cuál fue la solución alternativa. Este registro evita repetir la búsqueda y muestra qué pedirle al proveedor.
| data | o que tentei | o que barrou | contorno | status | |---|---|---|---|---|
POLITICA.md pide que también anote aquí todo experimento de ingeniería inversa, que es solo de laboratorio (módulo 4.4).💡 Clara miró primero
Ella pensaba que la agenda "no se conectaba con nada". Al revisar su propia hoja de cálculo, vio que podía guardarla como CSV, en el mismo formato que el agenda.csv del kit. Listo: nivel 6, sin parches improvisados.
Prueba rápida (opcional): el agente quiere leer un sistema que tiene una fila en CAPACIDADES.md, pero con «pendiente» en la última columna. ¿Qué ocurre?
lo que ya existe
menú olvidado
pantalla de configuración
lo que lo bloqueó
🎓 Resumen del módulo
Próxima ruta:
Ruta de aprendizaje 2 — Conectar: el mapa se convierte en puente, empezando por Claude usando Codex (2.1).