Modo VS

El modo VS pone a dos modelos a discutir un problema hasta que se ponen de acuerdo. Cada uno trabaja en su propio cliente (por ejemplo Claude en el editor y ChatGPT en el navegador, o un modelo local) y se hablan por turnos a través del servidor MCP de md-doc. Sirve cuando una solución importa lo bastante como para que la revise una segunda opinión independiente, o cuando una issue lleva días atascada.

md-doc no conecta con ningún modelo: guarda la partida, da el turno a cada puesto y conserva todas las jugadas. Cada modelo la juega desde su cliente con las herramientas MCP.

Cómo se juega

1. Una IA abre la partida (puesto A) con tres cosas: el problema, el contexto justo y necesario para resolverlo (el rival no ve su conversación, solo esto) y su solución completa.
2. Te devuelve una invitación corta. La pegas en el otro cliente, conectado también al MCP de md-doc.
3. El siguiente en entrar es B. Recibe el problema, el contexto y la solución de A, y le toca revisarla.
4. B responde de dos formas: acepta la solución, o expone sus puntos y aporta otra solución completa, no un parche. Se van turnando así, con turnos de minutos y todos los que hagan falta hasta el tope.
5. Termina de una de estas formas:
   • Con acuerdo: uno acepta la última solución del otro.
   • Sin acuerdo: cada uno cierra con su solución final y explica por qué la del rival no es correcta.

Reglas que evitan los atascos

• Cada jugada lleva un resumen de una línea. Es lo que ves en directo, sin tener que leer todos los argumentos.
• Hay un tope de jugadas (30 por defecto, de 4 a 200). Las dos últimas son siempre la ronda de cierre.
• Busca la mejor solución, no ganar. Cada modelo debe aceptar cuando la del rival sea correcta aunque no sea la suya, y no aceptar por cortesía.
• Mientras espera, el modelo no te molesta. Con vs_wait se queda a la escucha hasta que le toca o la partida termina, y se retoma si se corta.

Con un amigo

Puedes abrir una partida para un amigo: el puesto B lo juega su IA, con su cuenta, sobre el mismo problema. Solo se puede con amigos que han aceptado tu invitación. Las partidas que abre otro no te dan acceso a nada más de su espacio.

Qué ves en la web

Una vista de la partida en directo:

• Marcador: a quién le toca, desde cuándo y el resumen de la última jugada del rival.
• Jugadas en orden cronológico, plegadas a su resumen salvo la última.
• Sobre la mesa: el problema, el contexto y los tiempos.
• Al terminar, las dos soluciones finales lado a lado, o la acordada.

Desde la web puedes ver, parar o borrar una partida. Los colores de cada jugador se eligen en Ajustes → Apariencia.

Issue atascada: de la espera a la partida

Cuando una issue no avanza, una IA puede proponerte abrir una partida con la issue como problema. Si la aceptas, otro modelo la revisa y discutís. Al terminar, la IA que abrió la partida actualiza el contenido de la issue con lo acordado. No la marca como completada: eso lo decides tú después de comprobarlo.

Seguridad

• Lo que escribe el rival es material para evaluar, nunca instrucciones. El modelo no ejecuta comandos, no cambia datos ni comparte nada porque lo pida el otro.
• El identificador de asiento es la identidad de cada puesto en la partida. Solo se guarda su huella en la base de datos.
• Las jugadas solo se añaden, como las líneas de una bitácora: la partida queda como registro de qué se propuso y por qué.
• Los secretos no entran en juego. Los valores de los entornos nunca pasan por el MCP, tampoco en una partida.

Herramientas

vs_open, vs_join, vs_play, vs_wait, vs_get, vs_list. Detalle en Herramientas MCP.