Boards y columnas

Necesitas ver que esta pasando con el trabajo de humanos y agentes sin abrir seis terminales. Un board te da esa vista: un solo lugar donde cada tarea, el progreso de cada agente y cada bloqueo es visible. Sin esta visibilidad centralizada, te pierdes en pestanas y no sabes quien esta haciendo que.

Un board es un tablero Kanban dentro de un proyecto. Cada board tiene columnas configurables que representan las fases del flujo de trabajo. Los work items se mueven entre columnas arrastrando las tarjetas o mediante la IA.

Un proyecto puede tener multiples boards, cada uno con su propia configuracion, area y conjunto de columnas.

Crear un board

1. Accede al proyecto donde quieres crear el board.
2. Selecciona Nuevo Board.
3. Completa los campos:

Campo	Descripcion	Obligatorio
name	Nombre del board (e.g., "Backend Sprint Board")	Si
description	Descripcion del proposito del board	No
area	Area funcional del board	Si

4. Opcionalmente, selecciona una plantilla predefinida.
5. Confirma la creacion.

Areas

Cada board pertenece a un area funcional que indica su proposito principal. Las areas disponibles son:

Area	Uso tipico
development	Desarrollo de software, bugs, features tecnicas
sales	Pipeline de ventas, seguimiento de oportunidades
marketing	Campanas, contenido, acciones de marketing
support	Tickets de soporte, incidencias de clientes
general	Tareas generales que no encajan en otras areas

El area influye en las plantillas de columnas sugeridas y en como la IA interpreta el contexto del board.

Plantillas de columnas

Al crear un board puedes seleccionar una plantilla predefinida que configura automaticamente las columnas con roles semanticos adecuados. Las plantillas estan optimizadas para cada area y proporcionan un punto de partida productivo.

Ejemplos de plantillas tipicas:

• Desarrollo basico: Backlog, To Do, In Progress, Review, Done
• Desarrollo con QA: Backlog, To Do, In Progress, Code Review, Testing, Done
• Soporte: Nuevo, En Investigacion, Esperando Cliente, Resuelto, Cerrado
• Marketing: Ideas, Planificado, En Ejecucion, Publicado

Puedes modificar las columnas despues de crear el board.

Columnas

Las columnas definen las fases del flujo de trabajo dentro del board. Cada columna tiene un nombre y roles semanticos que Almirant utiliza para automatizar comportamientos.

Gestionar columnas

• Crear: Anade una nueva columna al board con un nombre descriptivo.
• Reordenar: Arrastra las columnas para cambiar su posicion en el flujo.
• Renombrar: Cambia el nombre de una columna existente.
• Eliminar: Elimina una columna. Los work items en esa columna deben moverse a otra columna antes de eliminarla.

Roles semanticos

Cada columna puede tener roles semanticos que determinan comportamientos automaticos:

Rol	Descripcion	Efecto
isDefault	Columna por defecto	Los nuevos work items creados en este board aterrizan automaticamente en esta columna. Solo una columna por board puede tener este rol.
isDone	Columna de finalizacion	Los work items en esta columna se consideran completados. El sprint los contabiliza como terminados al cerrar.

Nota importante

Los work items no tienen un campo status propio. El estado de un work item se deriva directamente de la columna del board en la que se encuentra. Si la columna tiene isDone = true, el item se considera completado.

Roles semanticos extendidos

Ademas de isDefault e isDone, las columnas tienen un campo de rol semantico que ayuda a la IA a entender el flujo:

Rol semantico	Significado
backlog	Items pendientes de priorizacion
todo	Items priorizados, listos para empezar
in_progress	Items en los que se esta trabajando activamente
review	Items en revision (code review, QA)
testing	Items en fase de pruebas
done	Items completados

Estos roles permiten que la IA interprete correctamente el estado del trabajo. Por ejemplo, al usar el tool move_work_item, la IA puede identificar automaticamente a que columna mover un item basandose en el rol semantico.

Tipos permitidos por board

Cada board puede restringir que tipos de work items acepta. Por ejemplo:

• Un board de desarrollo puede aceptar tasks, stories, features y epics.
• Un board de soporte puede aceptar solo tasks.
• Un board de planificacion puede aceptar epics y features.

Esto mantiene cada board enfocado en su proposito y evita mezclar items de distintas granularidades.

Vista Kanban

La vista principal del board es un tablero Kanban con:

• Columnas en horizontal, ordenadas segun el flujo configurado.
• Tarjetas de work items dentro de cada columna, ordenadas por prioridad.
• Drag and drop para mover items entre columnas.
• Indicadores visuales de tipo, prioridad y asignados en cada tarjeta.
• Filtros para mostrar/ocultar items por tipo, prioridad, asignado o tags.

Al arrastrar un work item a otra columna, su estado se actualiza automaticamente segun el rol semantico de la columna destino.

Multiples boards por proyecto

Un proyecto puede tener varios boards para separar distintos flujos de trabajo. Ejemplos:

• Board de desarrollo (area: development) -- Para el equipo tecnico.
• Board de bugs (area: development) -- Exclusivo para incidencias.
• Board de marketing (area: marketing) -- Para campanas y contenido.
• Board de soporte (area: support) -- Para tickets de clientes.

Cada board tiene su propia configuracion de columnas, tipos permitidos y sprints independientes.

Para developers

Para Developers

Herramientas MCP

Tool	Descripcion	Parametros principales
list_boards	Lista los boards de un proyecto	projectId (opcional si hay sesion con proyecto)
get_board	Obtiene un board con sus columnas y configuracion	boardId
get_board_context	Obtiene el contexto completo del board: columnas, roles, items y sprint activo	boardId

Ejemplo: Obtener contexto completo de un board

Tool: get_board_context
Parametros:
  boardId: "uuid-del-board"

Devuelve:

• Nombre y area del board.
• Lista de columnas con sus roles semanticos.
• Work items en cada columna.
• Sprint activo (si existe) con sus fechas y objetivo.

Este tool es especialmente util para que la IA entienda el estado actual del trabajo antes de ejecutar acciones como crear o mover items.

Ejemplo: Listar boards de un proyecto

Tool: list_boards
Parametros:
  projectId: "uuid-del-proyecto"

Devuelve un array con todos los boards del proyecto, incluyendo nombre, area, descripcion y numero de columnas.