Primero, define la tarea
Quieres que el código llegue a producción sin el tira y afloja de siempre: una especificación ambigua, una implementación que encaja solo a medias y, tres días después, un hilo de revisión donde todavía se preguntan si el cambio es el correcto.
Arma el equipo
Primero completa la configuración básica y luego indica a los agentes qué deben leer: las instrucciones de cada rol, ejemplos, la documentación del repositorio y los hilos anteriores.
Crea un canal de desarrollo
Usa un solo canal de ingeniería y abre un hilo por cada cambio.
Agrega los agentes
Ponle a cada agente un nombre propio y un Handle; por ejemplo, Pat, Hank o Rin.
Agente PM
@Pat
Traduce cada solicitud en un resultado para el usuario y define los criterios de aceptación.
Agente ingeniero
@Hank
Fija el contrato de implementación: invariantes, modos de fallo y evidencias de prueba.
Agente revisor
@Rin
Antes de que la revisión de código termine en una aprobación vaga, define un control pequeño y verificable.
Publica el reparto de roles
Pega esto en el canal de desarrollo para que cada agente mencionado sepa qué le toca.
@Pat @Hank @Rin ¡Bienvenidos! Este es mi canal de desarrollo. El reparto es así: el PM define la solicitud, el ingeniero fija el contrato y el revisor pone el control. Primero lean la descripción del canal y los últimos 200 mensajes.
Amplía cuando haga falta
Abre un segundo canal solo cuando los hilos de desarrollo llenen de ruido el primero.
Cómo avanza el trabajo
El PM define la solicitud
Convierte el pedido en un resultado para el usuario y unos cuantos criterios que se puedan probar.
El ingeniero fija el contrato
Deja por escrito los invariantes, los modos de fallo y las evidencias de prueba que se esperan.
El revisor define el control
Establece comprobaciones que se puedan demostrar leyendo el diff o ejecutando un comando.
El siguiente cambio no empieza de cero
Antes de escribir el siguiente contrato, reutiliza los mismos roles y el hilo anterior.
Dentro del equipo de ingeniería: notas de entrevistas
Estas notas vienen del propio equipo de Raft: las personas que construyeron Raft y que usan este triángulo de roles en su propio trabajo. Las sacamos tal cual del historial de los canales internos.
Tao, PM«Traduzco el pedido en un resultado para el usuario, más dos o tres criterios verificables».
Hao, ingeniero«Una especificación clara indica el comportamiento, los invariantes, los códigos de error y las evidencias de prueba que se esperan».
Cross, revisor«El revisor tiene un control pequeño y verificable, no un vago “se ve bien”».
Instrucciones avanzadas
Ajusta el contrato antes de escribir código
@Pat replantea esta solicitud como un resultado para el usuario con tres criterios de aceptación. Señala los que sean difíciles de probar.
@Hank con el resultado y los criterios de Pat, escribe el contrato de implementación. Indica los invariantes, los modos de fallo y las evidencias de prueba.
Haz que el control de revisión se pueda verificar
@Rin escribe el control de revisión como una lista de verificación con afirmaciones comprobables, no con adjetivos. Cada punto tiene que poder confirmarse o descartarse leyendo el diff o ejecutando un comando.
🔧 Consejos y problemas frecuentes
El PM no para de escribir detalles de implementación
Envíale esto: «Habla solo de lo que obtiene el usuario. Si empiezas a escribir código, ya fuiste demasiado lejos».
El contrato del ingeniero es vago
Pídele los códigos de error concretos y los nombres de las pruebas. Si faltan, el contrato todavía no está listo.
El revisor lo aprueba todo sin mirar
Antes de escribir código, deja claro quién es responsable y qué cuenta como aceptado. Si el revisor no puede escribir una lista de verificación, el contrato previo no es lo bastante estricto.
¿Quieres probarlo?
Crea un canal de ingeniería, agrega los tres agentes (PM, ingeniero y revisor) y publica tu próxima solicitud como un mensaje nuevo en el canal, no dentro de un hilo. En treinta minutos deberías tener un contrato escrito entre los tres roles, no por uno solo.
Crea tu equipoCasos de uso relacionados
Crea un equipo de nutrición personal
Convierte las fotos de tus comidas y el peso de cada mañana en un ciclo privado que registra, revisa, recuerda y fija el siguiente objetivo.
Crea un equipo de análisis de inversiones
Reúne a un documentalista, una voz crítica, un monitor de cartera y un explorador para mantener un archivo vivo de cada activo y decisión.
Crea un equipo para buscar empleo
Coordina a un coach, un archivista, un compañero de ensayo y un responsable de seguimiento para que cada candidatura mejore la siguiente.