Ayuda

Qué es MerebaKan

MerebaKan es un tablero para seguir el desarrollo de los proyectos de MEREBA. Cada trabajo es una tarjeta que va pasando por columnas, desde que alguien lo pide hasta que se da por terminado. Así todo el mundo ve en qué punto está cada cosa sin tener que preguntar.

Lo usan tres tipos de participantes: los dueños de proyecto (quienes encargan y aceptan el trabajo), el equipo de MEREBA (quienes lo desarrollan) y los asistentes de IA que ayudan al equipo desde sus repositorios. Cada cliente ve solo sus propios proyectos.

El método es un Scrumban sencillo: pocas columnas fijas, un tope de trabajo simultáneo y decisiones claras sobre quién mueve qué.

Quién es quién

Dueño del proyecto

Ve solo sus proyectos. Crea peticiones (entran en la Bandeja), puede corregir las suyas mientras sigan en la Bandeja, ordena el Backlog, deja comentarios y acepta o rechaza lo que llega a «Revisión del cliente». No ve los comentarios internos del equipo.

Observador

Alguien invitado a un proyecto solo para seguirlo. Ve el tablero, las fichas, los comentarios públicos y las métricas, pero no puede crear ni cambiar nada. Tampoco ve los comentarios internos.

Equipo MEREBA

Ve todos los proyectos y gestiona el flujo: crea y edita proyectos, invita a personas, crea tarjetas, las mueve entre columnas (siempre cumpliendo las reglas), las bloquea, gestiona las iteraciones y escribe comentarios internos o públicos.

Agentes de IA

Cuentas de máquina que trabajan por la API con un token. Pueden tomar tarjetas y moverlas por las columnas de trabajo, pero nunca a «Revisión del cliente» ni a «Hecho». Solo dejan comentarios internos. Más en Agentes de IA y API.

Cómo se entra

No hay contraseñas ni registro propio: hace falta que MEREBA te invite. El equipo da de alta tu correo en un proyecto y te llega un primer enlace.

1. Ve a la pantalla de entrada y elige cómo identificarte: con tu cuenta de Google (si aparece el botón) o pidiendo un enlace por correo.
2. Para el enlace, escribe tu correo y pulsa «Enviarme un enlace». Te llega un mensaje con un botón de acceso.
3. El enlace vale 15 minutos y se puede usar una sola vez. Ábrelo y pulsa «Entrar» para completar el acceso.
4. Para salir, usa el botón «Salir» de la cabecera.

Si tu correo no tiene acceso, la pantalla responde igual que si lo tuviera (no revela quién está dado de alta). Con Google solo entran las cuentas invitadas; el resto ve el mensaje «No hemos podido darte acceso».

Proyectos

La lista de Proyectos muestra los que puedes ver: el equipo los ve todos y cada dueño u observador, los suyos. Un proyecto al que no tienes acceso responde como si no existiera.

Un proyecto archivado lleva la etiqueta «Archivado» y queda de solo lectura para los clientes. El equipo sigue pudiendo trabajar en él.

Solo el equipo

• Nuevo proyecto: nombre, identificador, descripción, repositorio, URL de producción, límites de trabajo simultáneo y las definiciones de preparado y de hecho.
• Editar y Archivar desde el tablero del proyecto.
• Miembros: invitar a una persona como dueño u observador (recibe un enlace de acceso por correo) y quitarla.

El tablero y sus columnas

El tablero de un proyecto tiene siempre las mismas siete columnas, de izquierda a derecha. No se pueden añadir ni quitar.

1. Bandeja: peticiones nuevas de los dueños, todavía sin revisar por el equipo.
2. Backlog: trabajo pendiente ya aceptado. El orden de arriba abajo indica qué se hará antes.
3. Preparado: listo para empezar; la tarjeta ya tiene su criterio de aceptación.
4. En curso: alguien está trabajando en ello. Tiene límite de trabajo simultáneo.
5. Revisión interna: el equipo lo revisa antes de enseñarlo. También tiene límite.
6. Revisión del cliente: el trabajo está entregado y espera la decisión del dueño. Lleva un enlace de entrega.
7. Hecho: trabajo terminado. Lo normal es que llegue cuando el dueño acepta la entrega; el equipo también puede cerrar una tarjeta.

Cada tarjeta muestra su título, tipo, talla, responsable y cuántos días lleva en la columna. Para mover una tarjeta se arrastra a otra columna o se usan las flechas ← y →; solo se ofrecen los movimientos que tu rol permite. El desplegable «Iteración» filtra el tablero.

Las reglas del flujo

Límite de trabajo simultáneo (WIP)

«En curso» y «Revisión interna» tienen un máximo de tarjetas (4 por defecto; el equipo lo cambia al editar el proyecto). Si se supera, la columna se marca como «excedido». Es un aviso: no impide mover tarjetas, pero invita a terminar antes de empezar más.

Definición de preparado (DoR)

Para entrar en «Preparado» (y para seguir avanzando) la tarjeta necesita criterio de aceptación: qué tiene que cumplirse para darla por buena. Vale también al crear una tarjeta directamente en esas columnas. El texto de la definición se ve bajo el nombre de la columna.

Definición de hecho (DoD)

Para entrar en «Revisión del cliente» la tarjeta necesita un enlace de entrega (una dirección que empiece por http o https) donde el dueño pueda comprobar el trabajo.

Bloqueos

Si una tarjeta no puede avanzar, el equipo (o un agente, en sus columnas) la marca como bloqueada y debe escribir el motivo. Sigue en su columna, pero se ve resaltada con el motivo. Se quita con «Desbloquear».

Envejecimiento

Cada tarjeta indica cuántos días lleva en su columna. En Métricas se destacan las que llevan más tiempo del habitual.

Rechazar exige motivo

Si el dueño rechaza una entrega, debe explicar por qué. La tarjeta vuelve a «En curso» y el motivo queda como comentario visible.

Humano en el bucle

Un agente de IA nunca mueve una tarjeta a «Revisión del cliente» ni a «Hecho». La entrega a revisión la hace una persona del equipo y lo habitual es que la aceptación la decida el dueño (el equipo también puede cerrar una tarjeta).

La ficha de una tarjeta

Al abrir una tarjeta ves su ficha completa, con estos datos:

• Título y tipo: Historia, Error, Tarea o Cambio.
• Descripción y criterio de aceptación.
• Talla: una estimación de tamaño (XS, S, M, L o XL).
• Responsable: una persona del equipo o un agente.
• Referencia externa (por ejemplo, un enlace a otra herramienta), enlace de entrega e iteración.
• Quién la creó y cuándo, y cuántos días lleva en la columna.

Comentarios

Los comentarios públicos los ve todo el que ve el proyecto. Los internos (marcados «Interno») solo los ven el equipo y los agentes: el dueño y el observador no los ven, ni tampoco las líneas del historial que los mencionan. Los dueños solo escriben comentarios públicos; los agentes, solo internos.

Historial

Al final de la ficha, el historial lista cuándo se creó la tarjeta, cada movimiento, edición, bloqueo y comentario, y quién lo hizo.

Quién puede editar

El equipo edita todos los campos. El dueño solo puede cambiar título, tipo y descripción de sus propias peticiones mientras estén en la Bandeja.

Peticiones y revisión del dueño

Este es el recorrido de lo que pides:

1. En el tablero abre Nueva petición, escribe un título, elige el tipo y describe lo que necesitas. Al enviarla entra en la Bandeja y el equipo recibe un aviso por correo. Hay un tope de 20 peticiones por hora.
2. Mientras siga en la Bandeja puedes corregirla desde su ficha.
3. El equipo la revisa y la pasa al Backlog. Allí puedes ordenarla con las flechas ↑ y ↓ o arrastrando, para indicar qué te importa más.
4. Cuando el equipo termina, la tarjeta llega a Revisión del cliente. Te avisamos por correo (si tienes los avisos activados) y aparece arriba del tablero, en el bloque de entregas pendientes.
5. Abre el enlace de entrega y comprueba el trabajo. Pulsa Aceptar y la tarjeta pasa a Hecho; o pulsa Rechazar, escribe el motivo (obligatorio) y la tarjeta vuelve a En curso. El equipo recibe un aviso con tu decisión.

Aceptar y rechazar son los únicos movimientos que hace un dueño; el resto del flujo es del equipo.

Iteraciones

Una iteración es un periodo de trabajo con un nombre, un objetivo y, si se quiere, fechas de inicio y fin. Son opcionales.

• Solo las gestiona el equipo, desde el botón «Iteraciones» del tablero.
• Pasan por tres estados, siempre en este orden: planificada, activa y cerrada. Como mucho hay una activa por proyecto.
• El equipo asigna cada tarjeta a una iteración desde su ficha.
• Todos ven la iteración activa y su objetivo en la cabecera del tablero, y pueden filtrar el tablero por «Iteración activa» o «Sin iteración». El equipo puede además filtrar por cada iteración.

Métricas

La página de Métricas de cada proyecto (botón «Métricas» del tablero) está a la vista de todos los que ven el proyecto. Se calcula sola con el historial de movimientos.

Lead time

Cuánto pasa desde que se crea una tarjeta hasta que llega a «Hecho»: lo que espera quien la pidió.

Cycle time

Cuánto pasa desde que se empieza a trabajar en ella (la primera vez que entra en «En curso») hasta que llega a «Hecho».

p50 y p85

Dos formas de resumir los tiempos. El p50 (la mediana) es el valor típico: la mitad de las tarjetas tarda menos. El p85 es un valor prudente: 85 de cada 100 tarjetas tardan eso o menos. Se calculan con las tarjetas terminadas en los últimos 90 días.

Throughput semanal

Cuántas tarjetas se terminan cada semana. El gráfico muestra las últimas 12 semanas y el resumen, la media de las últimas 4.

Trabajo envejecido

Lista de tarjetas en curso ordenadas por los días que llevan en su columna. Se marcan las de «En curso», «Revisión interna» y «Revisión del cliente» que superan el p85 del cycle time: son las que conviene mirar primero.

Diagrama de flujo acumulado

Un gráfico de los últimos 30 días que apila, para cada día, cuántas tarjetas hay en cada columna. Si una banda se ensancha, ahí se está acumulando trabajo. Debajo del gráfico hay una tabla con los mismos datos.

Avisos por correo

MerebaKan envía pocos correos, y siempre después de que la acción se haya completado.

• Al dueño: cuando una tarjeta pasa a «Revisión del cliente» («Pendiente de tu revisión»), con el enlace de entrega y la ficha.
• Al equipo: cuando un dueño crea una petición, y cuando acepta o rechaza una entrega (con su motivo, en el rechazo).
• Resumen semanal al dueño, los lunes por la mañana: lo hecho en los últimos 7 días, lo pendiente de su revisión, lo que está en curso y lo bloqueado. Si no hay nada que contar, no se envía.

Los correos no incluyen comentarios internos ni motivos de bloqueo.

Desactivar los avisos de un dueño: lo hace el equipo desde «Miembros» del proyecto, con el botón de la columna «Avisos por correo». Afecta a los avisos inmediatos y al resumen semanal. Si quieres dejar de recibirlos, pídeselo a tu contacto en MEREBA.

Agentes de IA y API

Los asistentes de IA que trabajan en los repositorios de MEREBA usan la API v1 de MerebaKan. Cada petición lleva la cabecera X-Api-Token con el token del agente.

• El token lo crea una persona con acceso al servidor (no hay pantalla web para ello). Se muestra una sola vez, caduca (a los 90 días por defecto) y se puede revocar.
• Cada token tiene un ámbito, lectura o escritura, y está limitado a ciertos proyectos.
• Sin ningún token activo, la API está apagada.
• El script integracion/merebakan_cli.py permite usarla desde la terminal con los comandos proyectos, tarjetas, ver, crear, tomar, mover, entregar, comentar, bloquear y desbloquear.

Lo que un agente puede hacer

• Listar y leer las tarjetas de sus proyectos.
• Crear tarjetas en el Backlog.
• Tomar una tarjeta, moverla entre Backlog, Preparado, En curso y Revisión interna, y entregar el enlace de trabajo.
• Bloquear y desbloquear tarjetas en esas columnas.
• Comentar, siempre de forma interna.

Lo que no puede hacer

• Mover tarjetas a «Revisión del cliente» o «Hecho», ni sacarlas de la Bandeja.
• Escribir comentarios públicos.
• Tocar tarjetas de proyectos que su token no cubre.

Los ejemplos completos están en el documento docs/API_INTEGRACION.md del repositorio de MerebaKan, que mantiene el equipo.

Preguntas frecuentes