Tools - Boards

Tools para listar boards y obtener su estructura de columnas. Los boards son el componente central del flujo de trabajo en Almirant: cada board contiene columnas que representan estados (Backlog, To Do, In Progress, Review, Testing, Done).

---

list_boards

Lista todos los boards de la organizacion, incluyendo area y estado por defecto.

Parametros:

Este tool no requiere parametros.

Ejemplo:

{}

Respuesta:

[
  {
    "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

Obtiene un board por su ID, incluyendo sus columnas y el numero de work items en cada una.

Parametros:

Nombre	Tipo	Requerido	Descripcion
id	string (UUID)	Si	ID del board

Ejemplo:

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

Respuesta:

{
  "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

Obtiene todos los boards de un proyecto con un mapa semantico de columnas. El mapa asocia roles logicos (backlog, todo, inProgress, review, testing, done) con los IDs de columna correspondientes.

Este tool es esencial para que agentes de IA sepan a que columna mover un work item sin conocer los nombres exactos de las columnas configuradas.

Parametros:

Nombre	Tipo	Requerido	Descripcion
projectId	string (UUID)	No	ID del proyecto (usa el projectId de la sesion MCP si se omite)

Ejemplo:

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

Respuesta:

{
  "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"
      }
    }
  ]
}

Flujo recomendado para agentes

Antes de mover work items, llama a get_board_context para obtener el columnMap. Usa los IDs del mapa para operaciones como move_work_item o complete_ai_task sin depender de nombres de columna hardcodeados.

El mapeo de roles se realiza de la siguiente forma:

1. Si la columna tiene un role explicito configurado, se usa ese valor
2. Si no, el rol se infiere a partir del nombre de la columna (por ejemplo, "En Progreso" se mapea a in_progress)
3. Columnas que no coinciden con ningun patron conocido se asignan a other y no aparecen en el columnMap