Outils - Boards

Outils permettant de lister les boards et d'obtenir leur structure de colonnes. Les boards sont le composant central du flux de travail dans Almirant : chaque board contient des colonnes qui représentent des statuts (Backlog, To Do, In Progress, Review, Testing, Done).

---

list_boards

Liste tous les boards de l'organisation, y compris la zone et le statut par défaut.

Paramètres :

Ce tool ne requiert aucun paramètre.

Exemple :

{}

Réponse :

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

Obtient un board par son ID, y compris ses colonnes et le nombre de work items dans chacune d'elles.

Paramètres :

Nom	Type	Obligatoire	Description
id	string (UUID)	Oui	ID du board

Exemple :

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

Réponse :

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

Obtient tous les boards d'un projet avec une carte sémantique des colonnes. La carte associe des rôles logiques (backlog, todo, inProgress, review, testing, done) aux IDs de colonne correspondants.

Ce tool est essentiel pour que les agents IA sachent vers quelle colonne déplacer un work item sans connaître les noms exacts des colonnes configurées.

Paramètres :

Nom	Type	Obligatoire	Description
projectId	string (UUID)	Non	ID du projet (utilise le projectId de la session MCP s'il est omis)

Exemple :

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

Réponse :

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

Flux recommandé pour les agents

Avant de déplacer des work items, appelez get_board_context pour obtenir le columnMap. Utilisez les IDs de la carte pour des opérations telles que move_work_item ou complete_ai_task, sans dépendre de noms de colonnes codés en dur.

Le mappage des rôles s'effectue de la manière suivante :

1. Si la colonne possède un role explicite configuré, cette valeur est utilisée
2. Sinon, le rôle est déduit à partir du nom de la colonne (par exemple, "En Progreso" est mappé à in_progress)
3. Les colonnes qui ne correspondent à aucun modèle connu sont affectées à other et n'apparaissent pas dans le columnMap