Issues

Las issues son la unidad de trabajo. Toda tarea, bug o mejora vive como una issue con un identificador único, un estado y un responsable, que puede ser una persona o un agente.

Qué es

Una issue reúne todo lo necesario para llevar un trabajo de principio a fin:

• Identificador tipo DRAPPS-123: no es un texto libre, se compone de la clave del equipo (DRAPPS) más un número que se incrementa por equipo. Es estable y sirve para referenciar la issue desde ramas, PRs o comentarios.
• Título y descripción (markdown).
• Prioridad y estimación, en puntos de historia, no en horas (alimentan la velocity y el burndown). Para las horas está el control de horas.
• Estado del flujo (ver Estados de flujo).
• Responsable (assignee), creador y proyecto (toda issue vive en un proyecto; ver Proyectos).
• Ciclo e hito opcionales, para planificar.
• Fechas: de inicio, objetivo y de vencimiento (deadline).
• Campos personalizados del workspace: cliente, importe, fecha de entrega… Ver Campos personalizados.
• Tiempo dedicado, si tienes contratado el control de horas: cronómetro, entradas y total.

Checklist

La descripción admite listas de tareas: cada ítem se marca y se desmarca directamente, también leyendo (sin entrar en modo edición), y la ficha muestra el progreso «marcadas de la lista». Es la forma barata de trocear una tarea sin crear sub-issues.

Sub-issues y relaciones

• Sub-issues: una issue puede colgar de otra (relación padre/hijo) para descomponer trabajo grande en piezas.
• Relaciones de bloqueo: una issue puede bloquear o estar bloqueada por otra, de modo que el orden de ejecución quede explícito.

Etiquetas

Las etiquetas clasifican las tareas: «bug», «cliente», «para la demo»… Cada una tiene un nombre y un color, y una tarea puede llevar varias.

Crear y gestionar etiquetas

No hay una pantalla aparte: las etiquetas se crean y se editan desde la propia tarea. En la ficha, en el bloque Etiquetas, + Etiqueta abre el selector:

• Marca o desmarca las que quieras ponerle a la tarea.
• Nueva etiqueta crea una con el nombre que escribas y un color (hay ocho preparados y admite cualquier color en hexadecimal).
• Al pasar el ratón por una etiqueta aparecen el lápiz, para renombrarla o cambiarle el color, y la papelera.

Crear y editar etiquetas es cosa de los miembros del workspace, y borrarlas, de los admin. Un invitado con acceso de escritura a un proyecto pone y quita las que ya existen en sus tareas, pero no crea ni borra ninguna.

Las etiquetas que creas son del workspace: sirven en las tareas de todos sus proyectos. Las que trae una importación quedan en el equipo de destino y solo se ofrecen en sus tareas.

Borrar una etiqueta la quita de todas las tareas que la llevan, y no se puede deshacer. Las automatizaciones, las reglas SLA y los filtros guardados que la usaban no se corrigen solos: revísalos después.

Ponerlas y quitarlas

• En la ficha: con el selector de arriba. La × de cada etiqueta la quita.
• En el listado: cada fila tiene su selector (un icono de etiqueta si la tarea todavía no tiene ninguna). Puedes marcar varias seguidas sin que se cierre. Desde aquí se ponen las que ya existen; para crear una nueva, ve a la ficha.
• En el tablero: las tarjetas enseñan hasta dos etiquetas y un «+N» con el resto. Para cambiarlas, abre la tarea.
• Con una plantilla: la tarea nace con las etiquetas de la plantilla.

Quien puede editar las tareas de un proyecto puede ponerles y quitarles etiquetas. Un invitado de solo lectura las ve, pero no las toca. Por ahora no se pueden poner a varias tareas de golpe desde la selección múltiple.

Filtrar y agrupar

• El filtro Etiqueta, en el listado y en el tablero, enseña las tareas que llevan cualquiera de las etiquetas elegidas, combinado con el resto de filtros.
• Agrupar por etiqueta hace un grupo por etiqueta: una tarea con dos etiquetas sale en los dos, y las que no tienen ninguna van a Sin etiqueta. Agrupado así, el orden manual (arrastrar filas) no está disponible.

En automatizaciones y reglas SLA

• Una automatización puede tener como condición que la tarea tenga una etiqueta, y como acción añadir o quitar una.
• Una regla SLA puede aplicarse solo a las tareas con ciertas etiquetas.
• Poner o quitar una etiqueta no es un evento: no dispara automatizaciones ni webhooks salientes por sí mismo.

Desde un agente

Por el MCP, un agente consulta, crea, edita y borra etiquetas, con los mismos permisos que su usuario tiene en la app.

• list_labels devuelve las etiquetas del workspace: id, nombre, color y cuántas tareas visibles llevan cada una.
• save_label crea una etiqueta (sin id: name obligatorio y color opcional, en hexadecimal) o la renombra y le cambia el color (con id). Si ya hay una con ese nombre, sin distinguir mayúsculas, no la duplica: devuelve la que existe. Exige ser miembro del workspace.
• delete_label la borra, y solo lo puede hacer un admin. Sin confirm: true no borra nada: responde con lo que se vería afectado (tareas, plantillas, automatizaciones, reglas SLA y vistas que la usan). Con replaceWith y el id de otra etiqueta, las tareas y las plantillas pasan a llevar esa en vez de perderla. Las automatizaciones, las reglas SLA y las vistas no se cambian: la respuesta dice cuáles se quedan apuntando a la etiqueta borrada.
• save_issue las pone al crear la tarea con labelIds. Al actualizarla, se usan addLabelIds y removeLabelIds, que añaden y quitan sin tocar el resto; labelIds en una actualización se ignora.
• Un id que no existe en el workspace se descarta sin dar error, así que conviene sacar los ids de list_labels.

Una clave de API acotada a un proyecto no puede crear ni borrar etiquetas, porque son de todo el workspace.

No confundir con las etiquetas de proyecto

Hilbana tiene otras etiquetas, las de proyecto, que no van en las tareas: agrupan los proyectos en la barra lateral. Las gestiona un admin en Ajustes → Etiquetas de proyecto, cada proyecto lleva como mucho una, y se asignan con el clic derecho sobre el proyecto en la barra lateral o desde la ficha del proyecto. Borrar una no borra sus proyectos: se quedan sin etiqueta.

El plan Free admite 3 etiquetas de proyecto, y los de pago no tienen tope (ver Facturación y planes). Las etiquetas de tareas no tienen tope en ningún plan.

Estados y flujo

El estado no es un texto fijo: es un estado de flujo definido por cada equipo, clasificado por categoría (backlog, en curso, hecho, cancelado…). La app registra las transiciones con marcas de tiempo (cuándo empezó, cuándo se completó, cuándo se canceló) y usa la de completado para cerrar el cálculo de métricas como la velocity y el cycle time (ver Insights).

Contexto para agentes

Lo que hace a las issues de Hilbana distintas es que están pensadas para que un agente pueda tomarlas y ejecutarlas sin redescubrir el contexto cada vez:

• Contexto del agente (agentContext): notas en markdown con los archivos relevantes, el comando de verificación, la definición de hecho y cualquier apunte útil. Lo leen y escriben tanto la interfaz como el MCP.
• Definición de Ready (DoR): dos campos estructurados y máquina-verificables, definición de hecho (criterios de aceptación) y comando de verificación (por ejemplo pnpm build o los tests), que permiten decidir si una issue está lista para un agente.
• Claim / release: cuando un agente empieza a trabajar una issue, la reclama (queda marcada como “en curso por un agente”, con quién y desde cuándo). Es un bloqueo blando para que dos agentes no se pisen; al terminar, la libera. No se confunde con el responsable: el claim es “lo estoy tocando ahora”.

Comentar desde el listado

En el listado, el contador de comentarios de una tarea abre su hilo en un panel lateral, sin salir de la lista ni perder los filtros: se lee, se responde y se puede cerrar la tarea desde ahí mismo. El panel se redimensiona arrastrando su borde (doble clic vuelve al ancho por defecto) y recuerda el ancho.

Cómo se usa

1. Crea la issue con un título claro y su descripción.
2. Rellena su Definición de Ready (definición de hecho + comando de verificación) si quieres que un agente pueda tomarla.
3. Asígnala a una persona o a un agente, y sitúala en su proyecto (y ciclo, si aplica).
4. Muévela por los estados a medida que avanza; la app anota las transiciones.

Consulta también Estados de flujo, Ciclos y Agentes.