Documentación

Documentación › Maestro

Maestro

El Maestro es un Claude Code o un Codex que decide cuándo vale la pena repartir el trabajo. Recluta otras terminales con roles, prepara notas, portales y dibujos, sigue a cada una y cierra el equipo cuando termina.

Qué es el Maestro

MacWindowsLinuxdesde la 1.0.0

El Maestro es un Claude Code o un Codex que decide solo cuándo vale la pena repartir el trabajo. En tareas pequeñas trabaja solo; cuando hay partes independientes (frontend y backend, hacer y revisar, probar), recluta agentes conectados a él y dirige el equipo.

El Maestro recluta un Dev y un Revisor y les pasa la primera tarea

Paso a paso

  1. Activa el Maestro en una tarjeta de Claude Code o de Codex: en Nueva terminal, o con el botón de la varita en la barra de la tarjeta (“Convertir en Maestro”).
  2. Pide la tarea como siempre. Si quieres, dile cuántos agentes usar, o pídele que trabaje solo.
  3. Los reclutas aparecen debajo de él, conectados por cables, cada uno con la insignia de su rol. Reciben la primera tarea y le responden al Maestro cuando terminan.
  4. El Maestro sigue al equipo, te cuenta cómo avanza y cierra a los reclutas cuando su trabajo termina.

Los reclutas usan la misma IA que el Maestro; otra solo si la pides (“revisa con Codex”). Shells para builds y servidores puede abrirlos siempre. El equipo suele ser pequeño, de dos a cinco.

Ver tambiénActivar el MaestroCómo reclutaComandos del Maestro

Activar el Maestro

MacWindowsLinuxdesde la 1.0.0

El Maestro se activa por tarjeta, en tres lugares: en Nueva terminal, en el botón de la barra de la tarjeta y en el menú del clic derecho. El agente recibe el aviso al momento.

El botón del Maestro encendido en la barra y la insignia en la tarjeta
El botón del Maestro encendido en la barra y la insignia en la tarjeta

Paso a paso

  1. En Nueva terminal (⌘TCtrl+Shift+T), elige Claude Code o Codex y activa “Maestro”.
  2. En una tarjeta ya abierta, haz clic en el botón de la varita en la barra (“Convertir en Maestro”) o usa el clic derecho › “Maestro”.
  3. La tarjeta recibe la insignia “Maestro” y un aviso lo confirma. El agente recibe un mensaje que le dice que ahora es el Maestro.
  4. Para desactivarlo, usa el mismo botón (“Dejar de ser Maestro”) o el menú. Los reclutas siguen en el lienzo, conectados a él.
Nueva terminal⌘TCtrl+Shift+T

Solo Claude Code y Codex pueden ser Maestro. Un workspace puede tener más de uno.

Ver tambiénNueva terminal

Cómo recluta

MacWindowsLinuxdesde la 1.0.0

Cada recluta es una terminal nueva, conectada al Maestro, con un rol que él inventa para ese equipo. Además de agentes, crea notas, portales, árboles de archivos y tableros Draw, conecta las tarjetas entre sí y las agrupa.

Un Maestro con tres reclutas, una nota de plan y un Draw
Un Maestro con tres reclutas, una nota de plan y un Draw

Paso a paso

  1. Los reclutas entran debajo del Maestro, en su grupo, con la insignia del rol en el encabezado. Pasa el ratón por la insignia para leer las instrucciones de ese rol.
  2. Cada rol recibe un color: naranja, azul, rojo, morado, verde, cian, rosa o gris. Dos reclutas con el mismo rol tienen el mismo color.
  3. Lo que vale para todo el equipo va en una nota, conectada a quien la necesita. Para ver el sitio, abre un portal; para dibujar la arquitectura, un Draw; para mirar archivos, un árbol.
  4. En un servidor registrado, abre un shell allí y ejecuta los comandos él mismo.
  5. Los reclutas solo hablan entre sí por los cables que conecta el Maestro. Él les pasa nuevas tareas, les pregunta y mira la pantalla de cada uno.

Los roles valen solo para ese equipo: desaparecen con las tarjetas y no pasan al siguiente.

Ver tambiénComandos del MaestroRol… a mano

Rol… a mano

MacWindowsLinuxdesde la 1.0.0

También puedes darle un rol a cualquier terminal, con o sin Maestro. El rol aparece en la insignia de la tarjeta y el agente recibe el aviso.

El pedido del rol de una terminal
El pedido del rol de una terminal

Paso a paso

  1. Haz clic derecho en la terminal y elige “Rol…”. Con un rol ya asignado, el elemento muestra su nombre, como “Rol: Revisor…”.
  2. Escribe el nombre, por ejemplo Revisor, y haz clic en “Guardar”. La insignia aparece en el encabezado, con un color.
  3. Para quitar el rol, borra el nombre y guarda.

Un rol con el mismo nombre que el de otra tarjeta del workspace usa el mismo color.

Ver tambiénCómo recluta

Cerrar a los reclutas

MacWindowsLinuxdesde la 1.0.0

Cuando el trabajo de un recluta termina, el Maestro cierra la tarjeta, junto con las notas, los portales y los árboles que creó. Para cerrar una tarjeta que no reclutó, te lo pide a ti.

El Maestro pide cerrar una tarjeta que no es suya
El Maestro pide cerrar una tarjeta que no es suya

Paso a paso

  1. El Maestro cierra a sus propios reclutas solo. La sesión de cada uno termina; un agente va al historial del workspace, y un shell sale del lienzo.
  2. Para cerrar otra tarjeta, pregunta: “El Maestro … quiere cerrar …”. “Cerrar” lo permite; “No” mantiene la tarjeta.
  3. También puedes cerrar a un recluta como cualquier tarjeta.

Desactivar el Maestro no cierra nada: los reclutas quedan en el lienzo, conectados a él.

Ver tambiénRondas en el historial

Mover un Maestro con el equipo

Macdesde la 1.0.0

Al mover un Maestro a otro workspace sin sus reclutas, Octopus pregunta si el equipo va con él. Los que se quedan pasan a ser agentes comunes.

La pregunta al mover un Maestro
La pregunta al mover un Maestro

Paso a paso

  1. Selecciona el Maestro y usa el clic derecho › “Mover a workspace” › el destino.
  2. En “¿Llevar también el equipo del Maestro?”, elige “Llevar el equipo” para mover también a los reclutas, o “Solo el Maestro”.
  3. Las sesiones siguen en marcha durante el cambio. Un aviso dice adónde fueron, con “Ir a” el workspace y “Deshacer”.

Si mueves el grupo entero, el equipo ya va junto y Octopus no pregunta.

Ver tambiénMover tarjetas y grupos entre workspaces

Rondas en el historial

MacWindowsLinuxdesde la 1.0.0

Un Maestro cerrado, con sus reclutas cerrados junto con él, forma una ronda en el historial del workspace. Vuelve entera con un clic, cada agente en la misma conversación.

Una ronda del Maestro en el historial
Una ronda del Maestro en el historial

Paso a paso

  1. Abre el Historial del workspace (⌘YCtrl+Shift+Y) y elige “Rondas”.
  2. Cada fila muestra “Ronda de” y el nombre del Maestro, cuántos reclutas, la máquina, la carpeta y la última frase del Maestro.
  3. “Retomar la ronda” reabre el Maestro y los reclutas juntos y muestra el equipo en la pantalla.
  4. “Ver las tarjetas” lista cada una, para reabrir solo la que quieras.
Historial del workspace⌘YCtrl+Shift+Y

Ver tambiénRondas del MaestroCerrar a los reclutas