Boards et colonnes

Vous devez voir ce qui se passe dans le travail des humains et des agents sans ouvrir six terminaux. Un board vous donne cette vue : un seul endroit où chaque tâche, la progression de chaque agent et chaque blocage sont visibles. Sans cette visibilité centralisée, vous vous perdez entre les onglets et ne savez pas qui fait quoi.

Un board est un tableau Kanban au sein d'un projet. Chaque board possède des colonnes configurables qui représentent les étapes du workflow. Les work items passent d'une colonne à l'autre en faisant glisser les cartes ou via l'IA.

Un projet peut avoir plusieurs boards, chacun avec sa propre configuration, son domaine et son ensemble de colonnes.

Créer un board

1. Accédez au projet dans lequel vous souhaitez créer le board.
2. Sélectionnez New Board.
3. Remplissez les champs :

Champ	Description	Obligatoire
name	Nom du board (e.g., "Backend Sprint Board")	Oui
description	Description de l'objectif du board	Non
area	Domaine fonctionnel du board	Oui

4. Facultativement, sélectionnez un modèle prédéfini.
5. Confirmez la création.

Domaines

Chaque board appartient à un domaine fonctionnel qui indique son objectif principal. Les domaines disponibles sont :

Domaine	Utilisation typique
development	Développement logiciel, bugs, features techniques
sales	Pipeline commercial, suivi des opportunités
marketing	Campagnes, contenu, actions marketing
support	Tickets de support, incidents clients
general	Tâches générales qui ne correspondent pas aux autres domaines

Le domaine influe sur les modèles de colonnes suggérés et sur la façon dont l'IA interprète le contexte du board.

Modèles de colonnes

Lors de la création d'un board, vous pouvez sélectionner un modèle prédéfini qui configure automatiquement les colonnes avec des rôles sémantiques adaptés. Les modèles sont optimisés pour chaque domaine et offrent un point de départ productif.

Exemples de modèles courants :

• Développement de base : Backlog, To Do, In Progress, Review, Done
• Développement avec QA : Backlog, To Do, In Progress, Code Review, Testing, Done
• Support : Nouveau, En investigation, En attente du client, Résolu, Fermé
• Marketing : Idées, Planifié, En cours, Publié

Vous pouvez modifier les colonnes après avoir créé le board.

Colonnes

Les colonnes définissent les étapes du workflow au sein du board. Chaque colonne a un nom et des rôles sémantiques qu'Almirant utilise pour automatiser des comportements.

Gérer les colonnes

• Créer : Ajoutez une nouvelle colonne au board avec un nom descriptif.
• Réorganiser : Faites glisser les colonnes pour modifier leur position dans le workflow.
• Renommer : Modifiez le nom d'une colonne existante.
• Supprimer : Supprimez une colonne. Les work items de cette colonne doivent être déplacés vers une autre colonne avant sa suppression.

Rôles sémantiques

Chaque colonne peut posséder des rôles sémantiques qui déterminent des comportements automatiques :

Rôle	Description	Effet
isDefault	Colonne par défaut	Les nouveaux work items créés dans ce board arrivent automatiquement dans cette colonne. Une seule colonne par board peut avoir ce rôle.
isDone	Colonne de finalisation	Les work items de cette colonne sont considérés comme terminés. Le sprint les comptabilise comme achevés lors de sa clôture.

Note importante

Les work items n'ont pas de champ status propre. L'état d'un work item est directement dérivé de la colonne du board dans laquelle il se trouve. Si la colonne a isDone = true, l'item est considéré comme terminé.

Rôles sémantiques étendus

En plus de isDefault et isDone, les colonnes ont un champ de rôle sémantique qui aide l'IA à comprendre le workflow :

Rôle sémantique	Signification
backlog	Items en attente de priorisation
todo	Items priorisés, prêts à démarrer
in_progress	Items sur lesquels un travail est activement mené
review	Items en révision (code review, QA)
testing	Items en phase de test
done	Items terminés

Ces rôles permettent à l'IA d'interpréter correctement l'état du travail. Par exemple, avec le tool move_work_item, l'IA peut identifier automatiquement vers quelle colonne déplacer un item selon son rôle sémantique.

Types autorisés par board

Chaque board peut limiter les types de work items qu'il accepte. Par exemple :

• Un board de développement peut accepter les tasks, stories, features et epics.
• Un board de support peut n'accepter que les tasks.
• Un board de planification peut accepter les epics et les features.

Cela permet à chaque board de rester concentré sur son objectif et évite de mélanger des items de granularités différentes.

Vue Kanban

La vue principale du board est un tableau Kanban comportant :

• Des colonnes horizontales, ordonnées selon le workflow configuré.
• Des cartes de work items dans chaque colonne, triées par priorité.
• Le drag and drop pour déplacer des items entre les colonnes.
• Des indicateurs visuels de type, de priorité et de personnes assignées sur chaque carte.
• Des filtres pour afficher ou masquer les items par type, priorité, personne assignée ou tags.

Lorsqu'un work item est déplacé vers une autre colonne, son état est automatiquement mis à jour selon le rôle sémantique de la colonne de destination.

Plusieurs boards par projet

Un projet peut avoir plusieurs boards pour séparer différents workflows. Exemples :

• Board de développement (area: development) -- Pour l'équipe technique.
• Board de bugs (area: development) -- Réservé aux incidents.
• Board marketing (area: marketing) -- Pour les campagnes et le contenu.
• Board de support (area: support) -- Pour les tickets clients.

Chaque board possède sa propre configuration de colonnes, ses types autorisés et des sprints indépendants.

Pour les développeurs

Pour les développeurs

Outils MCP

Tool	Description	Paramètres principaux
list_boards	Liste les boards d'un projet	projectId (facultatif si une session contient un projet)
get_board	Obtient un board avec ses colonnes et sa configuration	boardId
get_board_context	Obtient le contexte complet du board : colonnes, rôles, items et sprint actif	boardId

Exemple : obtenir le contexte complet d'un board

Tool: get_board_context
Paramètres :
  boardId: "uuid-del-board"

Renvoie :

• Le nom et le domaine du board.
• La liste des colonnes avec leurs rôles sémantiques.
• Les work items de chaque colonne.
• Le sprint actif, s'il existe, avec ses dates et son objectif.

Ce tool est particulièrement utile pour que l'IA comprenne l'état actuel du travail avant d'exécuter des actions telles que la création ou le déplacement d'items.

Exemple : lister les boards d'un projet

Tool: list_boards
Paramètres :
  projectId: "uuid-del-proyecto"

Renvoie un tableau avec tous les boards du projet, notamment leur nom, domaine, description et nombre de colonnes.