Ferramentas - Boards

Ferramentas para listar boards e obter sua estrutura de colunas. Os boards são o componente central do fluxo de trabalho no Almirant: cada board contém colunas que representam estados como Backlog, To Do, In Progress, Review, Testing e Done.

---

list_boards

Lista todos os boards da organização, incluindo área e estado padrão.

Parâmetros: esta ferramenta não exige parâmetros.

Exemplo:

{}

Resposta:

[
  {
    "id": "b1234567-89ab-cdef-0123-456789abcdef",
    "name": "Engineering",
    "description": "Board principal de ingenieria",
    "area": "engineering",
    "isDefault": true,
    "createdAt": "2025-01-15T10:00:00.000Z",
    "updatedAt": "2025-01-15T10:00:00.000Z"
  }
]

---

get_board

Obtém um board pelo ID, incluindo as colunas e o número de work items em cada uma.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
id	string (UUID)	Sim	ID do board

Exemplo:

{
  "id": "b1234567-89ab-cdef-0123-456789abcdef"
}

Resposta:

{
  "id": "b1234567-89ab-cdef-0123-456789abcdef",
  "name": "Engineering",
  "description": "Board principal de ingenieria",
  "area": "engineering",
  "isDefault": true,
  "columns": [
    { "id": "col-001", "name": "Backlog", "order": 0, "isDone": false, "role": "backlog", "workItemCount": 12 },
    { "id": "col-002", "name": "To Do", "order": 1, "isDone": false, "role": "todo", "workItemCount": 5 },
    { "id": "col-003", "name": "In Progress", "order": 2, "isDone": false, "role": "in_progress", "workItemCount": 3 },
    { "id": "col-004", "name": "Review", "order": 3, "isDone": false, "role": "review", "workItemCount": 2 },
    { "id": "col-005", "name": "Done", "order": 4, "isDone": true, "role": "done", "workItemCount": 45 }
  ]
}

---

get_board_context

Obtém todos os boards de um projeto com um mapa semântico de colunas. O mapa associa funções lógicas, como backlog, todo, inProgress, review, testing e done, aos IDs de coluna correspondentes.

Essa ferramenta é essencial para que agentes de IA saibam para qual coluna mover um work item sem conhecer os nomes exatos das colunas configuradas.

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
projectId	string (UUID)	Não	ID do projeto; usa o projectId da sessão MCP se for omitido

Exemplo:

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000"
}

Resposta:

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000",
  "boards": [
    {
      "id": "b1234567-89ab-cdef-0123-456789abcdef",
      "name": "Engineering",
      "area": "engineering",
      "columns": [
        { "id": "col-001", "name": "Backlog", "order": 0, "isDone": false, "role": "backlog" },
        { "id": "col-002", "name": "To Do", "order": 1, "isDone": false, "role": "todo" },
        { "id": "col-003", "name": "In Progress", "order": 2, "isDone": false, "role": "in_progress" },
        { "id": "col-004", "name": "Review", "order": 3, "isDone": false, "role": "review" },
        { "id": "col-005", "name": "Testing", "order": 4, "isDone": false, "role": "testing" },
        { "id": "col-006", "name": "Done", "order": 5, "isDone": true, "role": "done" }
      ],
      "columnMap": { "backlog": "col-001", "todo": "col-002", "inProgress": "col-003", "review": "col-004", "testing": "col-005", "done": "col-006" }
    }
  ]
}

Fluxo recomendado para agentes

Antes de mover work items, chame get_board_context para obter columnMap. Use os IDs do mapa em operações como move_work_item ou complete_ai_task, sem depender de nomes de coluna hardcoded.

O mapeamento de funções é feito da seguinte maneira:

1. Se a coluna tiver uma role explícita configurada, esse valor será usado.
2. Caso contrário, a função será inferida do nome da coluna, por exemplo, "Em andamento" é mapeada para in_progress.
3. Colunas que não correspondem a nenhum padrão conhecido são atribuídas a other e não aparecem em columnMap.