Qué hace Maestro de osFoundry, un chat de IA que muestra cada paso que dio

Son las 4:40 de un jueves y Priya le ha pedido a un asistente de IA que añada un botón "Eliminar cuenta" a la página de ajustes de su app. La respuesta dice "Hecho, 4 archivos modificados". Antes de publicarlo quiere saber qué cuatro archivos son, qué leyó el asistente para decidirlo y si se acercó al código de facturación. Una ventana de chat normal solo le da el párrafo final.

Maestro en un párrafo

Maestro es el espacio de trabajo de IA con todas las herramientas dentro de la app de escritorio de osFoundry. Escribes la petición como en cualquier chat, pero la respuesta llega con su recorrido: cada archivo que listó, cada búsqueda que lanzó, cada archivo que leyó o editó y cada comando de terminal, cada uno en su propia fila con una duración que puedes desplegar. Puede trabajar dentro de una carpeta de tu ordenador, proponer cambios en lugar de escribirlos sin avisar y detenerse a enseñarte un plan antes de tocar nada. Lo encuentras como Maestro en la barra lateral. Si has usado ChatGPT o Claude en el navegador, imagina la misma conversación con el registro de actividad del agente y unos frenos al lado.

Un vistazo a la pantalla

• Pestañas de superficie en la parte superior. Maestro, Model chat, Multi chat, Research, Wiki y Code conviven en esta misma pantalla. Maestro es la pestaña con el conjunto completo de herramientas.
• Pestañas de detalle encima de la conversación: Chat, Sources, Files, Changelog, Tools, Pipeline y Logs. Son vistas distintas de la misma ejecución. Sources guarda en qué se basó la respuesta, Changelog lista los archivos que escribió este chat y Logs muestra los pasos y, en Costs, cuánto costó cada petición.
• Las filas del proceso en la transcripción. Aquí Maestro listó src/ (38 archivos), hizo grep de deleteUser, encontró 0 coincidencias y luego leyó account.ts y users.ts. Si haces clic en una fila, se abre y muestra la entrada y la salida exactas de esa llamada a la herramienta.
• La barra de control sobre el cuadro de mensaje: el interruptor del sandbox, Plan OFF/ON, Tools y Goal. Debajo del cuadro están los selectores de carpeta, proyecto, repo, Router y modelo.
• El panel de vista previa a la derecha, donde un archivo, un diff o una página web se abre junto a la conversación en lugar de sustituirla (Open File / App / Page, Browse Files, Browser).

Tres formas de usarlo

Una desarrolladora que quiere ver el plan antes del cambio

El caso de Priya del principio. El cambio toca cuentas y sesiones, así que prefiere leer el plan a revisar un diff sorpresa.

1. Hace clic en Plan en la barra de control para que ponga Plan ON.
2. Escribe "Add a Delete account button to settings" y lo envía.
3. Maestro lee seis archivos y no cambia ninguno. Con el modo plan activado, la propia app de escritorio rechaza cualquier herramienta que escriba un archivo o ejecute un comando, así que "solo lectura" no es una petición amable dentro del prompt.
4. Llega una tarjeta Plan marcada como "Awaiting approval", con los botones Approve y Cancel.

El plan del ejemplo nombra cuatro archivos, indica que src/billing/ queda intacto porque Stripe guarda sus propios registros y termina con "Nothing has been changed yet." El modo plan se desactiva solo cuando llega el plan. Priya pulsa Approve y solo entonces Maestro edita los cuatro archivos y ejecuta los tests (npm test -- account, 3 passed), todo visible como filas EDIT y TERMINAL. Si el plan no le hubiera gustado, Cancel habría dejado la carpeta exactamente como estaba.

Con qué se queda: un cambio que aprobó de antemano y una transcripción que muestra dónde miró el agente y qué ejecutó.

Un compañero nuevo orientándose en el código

Dan entró en el equipo el lunes. Necesita saber dónde está el bloqueo de login, pero en el código nadie lo llama "lockout", así que una búsqueda de texto no devuelve nada.

1. En Indexes añade una vez la carpeta del proyecto para que se pueda buscar por significado.
2. En un chat de Maestro sobre esa carpeta pregunta dónde bloquea la app a la gente tras varios logins fallidos.
3. Sigue las filas del proceso: una búsqueda en la carpeta que devuelve 2 resultados y luego un READ de throttle.ts.

La respuesta apunta a src/auth/throttle.ts (líneas 1–46) y src/routes/session.ts (líneas 22–61), y explica que el código nunca dice "lock out": tras cinco intentos fallidos fija un tiempo de espera de 15 minutos y devuelve 429 antes de comprobar la contraseña. Como la respuesta incluye rutas de archivo y las filas muestran lo que se leyó, Dan puede abrir esas mismas líneas en el panel de vista previa y comprobarlo él mismo en lugar de fiarse de un resumen. En este caso nada escribe en disco, así que puede dejar Approval Mode en su valor por defecto.

Con qué se queda: los dos archivos que importan, el motivo por el que la búsqueda por palabra clave no los encontró y un chat al que puede volver desde la lista de chats.

Una persona de marketing editando textos en un repo ajeno

Sammy escribe los textos de la página de lanzamiento, pero la página es un archivo React del repo de ingeniería. Quiere que el texto nuevo siga la guía de tono de docs/ y no quiere que se haga commit de nada sin revisarlo.

1. Abre el menú Approval Mode del compositor y elige Permission & Approve, que pregunta antes de cada llamada a herramienta. Las otras opciones son Auto Accept (la predeterminada, las herramientas se ejecutan al momento), Plan First (planificar antes de ejecutar) y Bypass (ninguna aprobación, ni siquiera para push o envío de formularios).
2. Activa el sandbox para que las escrituras se preparen en una rama en lugar de caer en la carpeta de trabajo.
3. Le pide a Maestro un borrador de la página de lanzamiento coherente con la documentación. Lee docs/tone.md, busca en el código y propone un cambio en src/Launch.tsx.
4. El diff se abre en el panel de vista previa. Lo acepta y luego usa Export to branch para que alguien de ingeniería lo revise como cualquier otro cambio.

Con qué se queda: un texto que cita la guía de tono que siguió (la pestaña Sources la conserva), un diff revisado y una rama en lugar de una sorpresa en main.

Dónde encaja Maestro frente a Model chat, Chat y Multi chat

Maestro comparte pantalla con hermanos más sencillos, y elegir el adecuado ahorra tiempo y dinero.

• Model chat es una pestaña de la misma pantalla que envía cada turno a un único modelo que eliges. Es una conversación de solo lectura: sin carpeta, sin herramientas que actúen, sin aprobaciones. Ideal para una pregunta rápida.
• Chat tiene su propio sitio en la barra lateral. También responde con un modelo que eliges para toda la conversación, pero conserva las capacidades sobre archivos, así que puede proponer un cambio que aceptas (Accept) o rechazas (Reject), registrado en Changelog. Úsalo cuando quieras que un modelo concreto haga el trabajo, sin un router que decida por ti.
• Multi chat hace la misma pregunta a varios modelos a la vez. En Compare lees las respuestas en paralelo; en Council los modelos responden, puntúan a ciegas las respuestas de los demás y uno escribe una síntesis.

Desde Maestro el trabajo suele pasar a otras partes de la app. Research convierte una pregunta en un informe con citas, Code ejecuta un agente de programación en su propia rama, Indexes hace que una carpeta se pueda buscar por significado (como en el caso de Dan) y Version → Merge Station es donde se fusionan los cambios del sandbox. Si un turno sale mal, escribir /rewind en el chat restaura los archivos que cambió ese turno. Para profundizar, la página de orquestación de Maestro recorre las pestañas de detalle y la página del modo plan explica el flujo de aprobación.

Las primeras preguntas que hace la gente

¿El modo plan es solo una instrucción en el prompt?
No. Mientras Plan está en ON, cualquier herramienta que no esté en la lista de solo lectura se rechaza cuando la app la despacha, así que el agente puede leer, buscar y navegar, pero no puede editar ni ejecutar comandos hasta que apruebes el plan.

¿Qué diferencia hay entre el interruptor Plan y Plan First en Approval Mode?
Plan es un interruptor puntual para la siguiente petición: investigar, presentar un plan, esperar. Approval Mode es la regla fija del chat para las llamadas a herramientas, de Auto Accept a Bypass. Plan First es uno de sus cuatro ajustes.

Hay muchas filas de proceso. ¿Puedo ocultarlas?
Sí. El ajuste Process Detail alterna entre Full y Compact. Solo cambia cómo se muestran los pasos, no cómo se ejecuta el turno.

¿Qué modelo usa Maestro?
Por defecto el Router elige un modelo en cada turno, y las filas del proceso muestran cuál se ejecutó. Puedes cambiar el modo de modelo (en la nube, local o autoalojado) desde el compositor, o usar Chat cuando quieras fijar un único modelo para toda la conversación.

Puedes descargar la app de escritorio en osfoundry.io/es/download.