Participantes y lanes

Un participante es un archivo de tu repositorio. Una lane es su tarjeta en el panel. Cómo se arma un equipo, qué guarda cada uno y qué te deja hacer el panel con ellos.

Un participante es un archivo #

Un participante es .autodev/participants/<id>.md: frontmatter y, después, las instrucciones del propio participante en prosa. El nombre del archivo es la identidad. Un id del frontmatter que no coincida con él se ignora.

---
provider: codex
failover: [claude]
moves: [say, work_done, handoff, wait, gate, done]
---
Your instructions to this participant.

model y effort nunca se comprueban contra una lista. AutoDev no mantiene una lista de modelos, así que un modelo lanzado esta mañana funciona esta mañana.

Los commits del propio AutoDev dejan .autodev/ fuera, así que un archivo de participante solo se versiona si lo haces commit tú. Esa decisión es tuya.

Armar un equipo #

No existe un equipo implícito. Un proyecto sin archivos de participante no ejecuta nada, y el panel se abre en la configuración del equipo. Tres caminos llevan a un equipo, y todos escriben archivos de participante:

• Arrastra un proveedor de la fila de providers a la cuadrícula. Añade un participante, con el nombre del proveedor.
• Empieza por una plantilla: solo es un participante que se ocupa del objetivo, builder-reviewer añade un revisor que comprueba cada cambio antes de que la ejecución siga, y manager-builder-reviewer añade un gestor que divide el objetivo y reparte los bloques. El formato del archivo de participante describe qué escribe cada plantilla.
• Empieza con tu equipo predeterminado, que se copia al proyecto. El equipo que armas se guarda como predeterminado cuando aún no hay uno, y Save as default team lo reemplaza por este. Vive en ~/.autodev/team/, así que se arma una vez y no por carpeta.

Un equipo que llegó con el proyecto no corre hasta que lo confirmes en esta máquina. Sus archivos se convierten en banderas e instrucciones de una CLI, y un archivo puede nombrar cualquier cosa. El panel dice This project came with a team, y Use this team lo confirma. autodev team hace todo esto desde la terminal.

Fijado o predeterminado #

Un participante sin model y sin effort no está fijado: AutoDev no pasa ninguna bandera de modelo ni de esfuerzo, y vale el valor predeterminado de la propia CLI. Fijar y desfijar están en la lane, y escriben esas mismas dos claves en el archivo. Una fijación vale desde el siguiente turno del participante, nunca a mitad de uno. Nombra un modelo del proveedor del propio participante, así que en un salto de failover no se aplica. El model y el effort de la ejecución no son un plan B: ningún turno de un participante los lee.

Quién habla primero #

El equipo se ordena por nombre. Cuando nadie pasa el turno, los turnos siguen ese orden, y el primer nombre abre un hilo. Cada lane lleva su posición como un número, y el panel explica el orden bajo la cuadrícula: They take turns in this order — <names> — because a team is sorted by name, and <first> opens a thread when nobody hands the turn on. Rename to reorder.

Añadir un participante desde el panel escribe un archivo con el nombre del proveedor, luego claude-2, claude-3 y así sucesivamente. Renombrar cambia el orden, y mueve el archivo con su fijación y sus instrucciones, y la sesión con él. El hilo conserva el nombre antiguo en las publicaciones ya escritas: una publicación registra quién habló.

Una lane es una tarjeta #

El destino CLIs muestra una tarjeta por participante. Una tarjeta es la lane de ese participante. Muestra:

• el nombre y el proveedor;
• el número de su posición en el orden;
• su estado: its turn, idle, open in an editor tab o not installed;
• cuando corre en otra CLI, una línea que dice por qué, como Running on codex: claude hit its usage limit and is back at <time>.;
• un pie: default, default · <model it last ran> o default · model not reported by codex, o pinned · <model> · effort <effort>;
• las tres últimas cosas que dijo o ejecutó.

Las acciones son Open o Focus tab, fijar o desfijar, renombrar, Edit prompt, que abre el archivo del participante en el editor, y Remove. Renombrar y Remove se rechazan mientras el participante está en un turno, y la tarjeta dice <id> is taking a turn — wait for it to finish, or stop the run first. Una lane cuyo proveedor falta dice <provider> is not available on this machine. y ofrece Adopt a binary… y Copy install. La terminal hace lo mismo: autodev team edit imprime la ruta del archivo, y pin, unpin, rename y remove hacen lo que hacen los botones.

Qué hace Open #

Open abre un terminal en una pestaña del editor llamada AutoDev · <id>, con la CLI del participante en modo interactivo. La línea de comandos lleva la fijación del participante y el servidor MCP del propio AutoDev, sumado al tuyo y sin reemplazarlo nunca. Es donde inicias sesión en una CLI o eliges un modelo. No es donde se ejecuta un turno del hilo: los turnos se ejecutan sin interfaz, desde el daemon.

Open no envía nada a la ejecución. La ejecución no se pausa, y un turno en curso sigue escribiendo en el repositorio mientras tecleas en el terminal. El panel no tiene ningún control que quite del hilo la sesión de una lane, ni que la bifurque.

El formato del archivo de participante trae el formato exacto del archivo. El hilo compartido cubre lo que hace un participante en un turno, y Proveedores y failover cubre failover. Todas las claves de configuración enumera el provider de la ejecución, en el que corre un participante que no nombra ninguno.