Boards e colunas

Você precisa ver o que está acontecendo com o trabalho de pessoas e agentes sem abrir seis terminais. Um board oferece essa visão: um único lugar onde cada tarefa, o progresso de cada agente e cada bloqueio ficam visíveis. Sem essa visibilidade centralizada, você se perde entre abas e não sabe quem está fazendo o quê.

Um board é um quadro Kanban dentro de um projeto. Cada board tem colunas configuráveis que representam as fases do fluxo de trabalho. Os work items são movidos entre colunas arrastando os cartões ou por meio da IA.

Um projeto pode ter vários boards, cada um com sua própria configuração, área e conjunto de colunas.

Criar um board

1. Acesse o projeto em que você quer criar o board.
2. Selecione Novo Board.
3. Preencha os campos:

Campo	Descrição	Obrigatório
name	Nome do board (e.g., "Backend Sprint Board")	Sim
description	Descrição da finalidade do board	Não
area	Área funcional do board	Sim

4. Opcionalmente, selecione um modelo predefinido.
5. Confirme a criação.

Áreas

Cada board pertence a uma área funcional que indica sua finalidade principal. As áreas disponíveis são:

Área	Uso típico
development	Desenvolvimento de software, bugs, features técnicas
sales	Pipeline de vendas, acompanhamento de oportunidades
marketing	Campanhas, conteúdo, ações de marketing
support	Tickets de suporte, ocorrências de clientes
general	Tarefas gerais que não se encaixam em outras áreas

A área influencia os modelos de coluna sugeridos e a forma como a IA interpreta o contexto do board.

Modelos de coluna

Ao criar um board, você pode selecionar um modelo predefinido que configura automaticamente as colunas com papéis semânticos adequados. Os modelos são otimizados para cada área e fornecem um ponto de partida produtivo.

Exemplos de modelos típicos:

• Desenvolvimento básico: Backlog, To Do, In Progress, Review, Done
• Desenvolvimento com QA: Backlog, To Do, In Progress, Code Review, Testing, Done
• Suporte: Novo, Em investigação, Aguardando cliente, Resolvido, Fechado
• Marketing: Ideias, Planejado, Em execução, Publicado

Você pode modificar as colunas depois de criar o board.

Colunas

As colunas definem as fases do fluxo de trabalho dentro do board. Cada coluna tem um nome e papéis semânticos que o Almirant usa para automatizar comportamentos.

Gerenciar colunas

• Criar: Adicione uma nova coluna ao board com um nome descritivo.
• Reordenar: Arraste as colunas para alterar sua posição no fluxo.
• Renomear: Altere o nome de uma coluna existente.
• Excluir: Exclua uma coluna. Os work items nessa coluna devem ser movidos para outra coluna antes da exclusão.

Papéis semânticos

Cada coluna pode ter papéis semânticos que determinam comportamentos automáticos:

Papel	Descrição	Efeito
isDefault	Coluna padrão	Os novos work items criados nesse board chegam automaticamente a essa coluna. Apenas uma coluna por board pode ter esse papel.
isDone	Coluna de finalização	Os work items nessa coluna são considerados concluídos. O sprint os contabiliza como finalizados ao encerrar.

Observação importante

Os work items não têm um campo status próprio. O estado de um work item é derivado diretamente da coluna do board em que ele se encontra. Se a coluna tiver isDone = true, o item será considerado concluído.

Papéis semânticos estendidos

Além de isDefault e isDone, as colunas têm um campo de papel semântico que ajuda a IA a entender o fluxo:

Papel semântico	Significado
backlog	Items pendentes de priorização
todo	Items priorizados, prontos para começar
in_progress	Items em que o trabalho está sendo feito ativamente
review	Items em revisão (code review, QA)
testing	Items na fase de testes
done	Items concluídos

Esses papéis permitem que a IA interprete corretamente o estado do trabalho. Por exemplo, ao usar a tool move_work_item, a IA pode identificar automaticamente para qual coluna mover um item com base no papel semântico.

Tipos permitidos por board

Cada board pode restringir os tipos de work items que aceita. Por exemplo:

• Um board de desenvolvimento pode aceitar tasks, stories, features e epics.
• Um board de suporte pode aceitar apenas tasks.
• Um board de planejamento pode aceitar epics e features.

Isso mantém cada board focado em sua finalidade e evita misturar items com diferentes níveis de granularidade.

Visualização Kanban

A visualização principal do board é um quadro Kanban com:

• Colunas na horizontal, ordenadas de acordo com o fluxo configurado.
• Cartões de work items dentro de cada coluna, ordenados por prioridade.
• Drag and drop para mover items entre colunas.
• Indicadores visuais de tipo, prioridade e responsáveis em cada cartão.
• Filtros para mostrar ou ocultar items por tipo, prioridade, responsável ou tags.

Ao arrastar um work item para outra coluna, seu estado é atualizado automaticamente de acordo com o papel semântico da coluna de destino.

Vários boards por projeto

Um projeto pode ter vários boards para separar diferentes fluxos de trabalho. Exemplos:

• Board de desenvolvimento (área: development) -- Para a equipe técnica.
• Board de bugs (área: development) -- Exclusivo para ocorrências.
• Board de marketing (área: marketing) -- Para campanhas e conteúdo.
• Board de suporte (área: support) -- Para tickets de clientes.

Cada board tem sua própria configuração de colunas, tipos permitidos e sprints independentes.

Para desenvolvedores

Para desenvolvedores

Ferramentas MCP

Tool	Descrição	Parâmetros principais
list_boards	Lista os boards de um projeto	projectId (opcional se houver uma sessão com projeto)
get_board	Obtém um board com suas colunas e configuração	boardId
get_board_context	Obtém o contexto completo do board: colunas, papéis, items e sprint ativo	boardId

Exemplo: obter o contexto completo de um board

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

Retorna:

• Nome e área do board.
• Lista de colunas com seus papéis semânticos.
• Work items em cada coluna.
• Sprint ativo, se houver, com suas datas e objetivo.

Essa tool é especialmente útil para que a IA entenda o estado atual do trabalho antes de executar ações como criar ou mover items.

Exemplo: listar os boards de um projeto

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

Retorna um array com todos os boards do projeto, incluindo nome, área, descrição e número de colunas.