Un cerebro, un par de manos y un pedal de freno
· 4 min read
yoke llm ai elixir erlang architecture programming opinion hacking
El asistente acababa de anunciar que todo estaba arreglado. Los tests discrepaban. Tres archivos yacían abiertos sobre la mesa como declaraciones contradictorias de testigos, y el terminal tenía el resplandor exhausto de un bar que debería haber cerrado una hora antes.
—Quizá —sugerí— podríamos probar con la ingeniería.
Ya he defendido que el modelo es un motor, no un coche. Yoke es mi intento de añadirle la dirección, los instrumentos y el pedal de freno. Escrito en Elixir sobre Erlang/OTP, trata una sesión de agente como un sistema en funcionamiento, no como una ventana de chat desechable con permiso para destrozar un repositorio.
Mantén el cerebro lejos de las herramientas eléctricas
Yoke llama a esta separación Brain/Hands : cerebro y manos. El cerebro mantiene la conversación y el estado del agente en un GenServer aislado. Las manos ejecutan las herramientas por separado. La supervisión de OTP contiene el fallo de un proceso de herramienta en lugar de dejar que se lleve por delante toda la conversación.
flowchart LR
U["Tú"] <--> B["Cerebro<br/>conversación y decisiones"]
B <--> H["Manos<br/>ejecución supervisada de herramientas"]
H --> L["Espacio de trabajo local"]
H --> R["Nodo Erlang remoto"]
H --> D["Contenedor Docker"]
Dónde se ejecuta el modelo y dónde se ejecutan las herramientas son decisiones independientes. La inferencia local no implica ejecución remota; ejecutar herramientas en remoto no obliga a externalizar el cerebro.
Los lotes de llamadas a herramientas pueden ejecutarse de forma concurrente, con bloqueos de escritura por archivo. Los flujos de trabajo más grandes dan a cada subtarea paralela su propio worktree de Git y su propia rama. Dos asistentes no deberían compartir un árbol de trabajo sin protección, del mismo modo que dos cirujanos no deberían compartir una venda para los ojos.
Dale un mapa, no otra pala
Volcar un repositorio en una ventana de contexto no es comprenderlo. Es montar un vertedero con factura de API.
Metastaticproporciona una representación MetaAST compartida mediante adaptadores de lenguaje. Ragex aprovecha esa base junto con analizadores nativos: símbolos, relaciones entre llamadas, búsqueda semántica e híbrida, análisis de impacto y refactorización estructural. Yoke incorpora esas herramientas a la conversación a través de MCP.
flowchart LR
S["Código fuente"] --> M["Metastatic<br/>MetaAST compartido"]
S --> N["Analizadores nativos"]
M --> R["Ragex<br/>grafo, búsqueda, refactorización"]
N --> R
R --> Y["Yoke<br/>contexto y herramientas para la tarea"]
Ahora, «¿quién llama a esto?» tiene detrás algo mejor que una conjetura pronunciada con aplomo. Un cambio de nombre puede seguir las referencias en vez de hacerse pasar por un accidente de buscar y reemplazar. El soporte varía según el lenguaje y la operación; un diagrama no es un certificado de corrección universal.
La cuestión no es conseguir que el modelo lo lea todo más deprisa. Es dejar de obligarlo a leerlo todo.
El arrepentimiento debería tener remite
Hay dos clases distintas de recuperación, y confundirlas es la manera de convertir una demostración en un informe de incidente.
Las
instantáneas de conversación
conservan los mensajes y la configuración del proveedor. Guarda una con
/checkpoint before-refactor
;
/undo
restaura el estado de la conversación.
No
rebobina el árbol de trabajo, no deshace una orden de shell ni recupera un correo ya enviado.
Las transacciones de código pertenecen a las herramientas de edición de Ragex: validar previamente un cambio que afecta a varios archivos, conservar copias de seguridad, aplicar ediciones coordinadas y revertirlas si algo falla. Utiliza esa vía cuando los cambios deban viajar juntos. No es una transacción mágica que abarque efectos secundarios arbitrarios de la shell, y validar la sintaxis sigue sin sustituir a los tests.
Mientras tanto, las sesiones se guardan como narraciones LMML legibles. Retómalas con
yoke -c
, comprime una conversación desmesurada con
/compact
y consulta
/tokens
o
/cost
en lugar de reservar la factura para el giro final del guion.
Quiero un asistente capaz de recuperarse de una mala idea. De las mías, también.
Una conversación es una interfaz
El terminal no debería ser el castigo por negarte a pagar una suscripción a un IDE.
-
Escribe
@para abrir un buscador de archivos integrado que respeta las reglas de gitignore; adjunta un archivo o una URL sin montar una sesión de espiritismo a base de copiar y pegar. -
Abre
/explorerpara inspeccionar la configuración, las reglas, las conversaciones, las prácticas, los trabajos, las habilidades, los diagnósticos y las analíticas. Controles de verdad, no una búsqueda del tesoro entre archivos ocultos. - Redacta mensajes multilínea, busca en el historial de entrada, utiliza un editor externo y responde a preguntas estructuradas cuando el agente necesite una decisión, no una licencia para improvisar.
-
Pasa a
!!para trabajar directamente en la shell y vuelve después a la conversación. No todas las órdenes necesitan un modelo de lenguaje haciendo de guardia de tráfico a precio de abogado.
Haz que la disciplina se pueda compartir
Las reglas con ámbito y las prácticas de lenguaje aprendidas sacan las convenciones del ritual diario de regañar al asistente. Las habilidades, los servidores MCP y los complementos recargables en caliente amplían las herramientas. Los flujos de trabajo pueden codificar la creación de ramas, los tests, la documentación, el análisis estático y los commits; las herramientas de revisión y auditoría devuelven las pruebas al centro del proceso.
Los perfiles de proveedor cambian el modelo y el endpoint a la vez. Los perfiles locales integrados se mantienen en la interfaz de bucle local y no recurren a escondidas a un servicio remoto. «Local» debería describir adónde va la petición, no los sentimientos del vendedor sobre la privacidad.
Nada de esto hace infalible al autocompletado. Sus errores simplemente están menos solos, cuestan menos y resultan más fáciles de inspeccionar.
Ese es el arnés que quiero: un cerebro que no pierda el hilo, unas manos que trabajen dentro de unos límites y un pedal de freno que no esté simplemente pintado.
Feliz hacking.