Dépendances entre items

Lorsque plusieurs agents travaillent en parallèle, ils se gênent mutuellement à moins que vous ne définissiez ce qui bloque quoi. Les dépendances rendent cela explicite afin que les agents respectent automatiquement l'ordre d'exécution. Sans dépendances claires, vous vous retrouvez avec des conflits de merge, du travail dupliqué et des agents qui implémentent des features sur du code qui n'existe pas encore.

Les dépendances permettent de définir des relations de blocage entre work items. Lorsqu'un item dépend d'un autre, Almirant rend cette relation visible pour que l'équipe comme l'IA puissent prendre des décisions éclairées sur l'ordre d'exécution du travail.

Types de dépendance

Almirant utilise un modèle de dépendance bidirectionnel fondé sur les relations blocker/blocked :

Relation	Signification	Exemple
blocks	L'item A bloque l'item B	« Implémenter l'API utilisateurs » bloque « Créer l'écran de profil »
blocked by	L'item B est bloqué par l'item A	« Créer l'écran de profil » est bloqué par « Implémenter l'API utilisateurs »

Les deux relations sont les deux faces d'une même dépendance. Lorsque vous créez une dépendance depuis l'un des deux items, la relation inverse est automatiquement établie.

Créer une dépendance

Depuis l'interface

1. Ouvrez la vue détaillée d'un work item.
2. Accédez à la section Dependencies.
3. Sélectionnez Add dependency.
4. Recherchez le work item concerné par son titre ou son taskId (e.g., A-T-15).
5. Sélectionnez le type de relation : « cet item bloque... » ou « cet item est bloqué par... ».
6. Confirmez.

La dépendance apparaît dans la vue détaillée des deux items concernés.

Via MCP

Utilisez le tool add_work_item_dependency en fournissant les IDs des deux items et le type de relation.

Voir les dépendances

Les dépendances d'un work item sont affichées dans :

• Vue détaillée -- Section dédiée qui montre les items bloquants et bloqués.
• Carte du board -- Indicateur visuel lorsqu'un item a des dépendances actives.

Chaque dépendance affiche :

• Le taskId et le titre de l'item associé.
• Le type de relation (blocks / blocked by).
• L'état actuel de l'item associé, dérivé de sa colonne.

Consultation en lot

Lorsque vous devez vérifier les dépendances de plusieurs items à la fois, par exemple en planifiant un sprint, vous pouvez utiliser la consultation en lot afin d'obtenir toutes les relations d'un ensemble de work items en une seule opération.

Impact sur le workflow

Les dépendances fournissent des informations clés pour la gestion du travail :

• Visibilité des blocages -- Identifiez rapidement les items qui ne peuvent pas avancer parce qu'ils dépendent d'autres items encore non terminés.
• Priorisation éclairée -- Les items qui en bloquent d'autres doivent être priorisés afin de débloquer le travail en attente.
• Contexte pour l'IA -- Lorsque l'IA consulte le contexte d'un item, les dépendances l'aident à déterminer s'il est pertinent de commencer à y travailler ou si elle doit d'abord se concentrer sur les items bloquants.

Bonne pratique

Un item bloqué ne devrait pas être déplacé vers « In Progress » tant que ses items bloquants ne sont pas terminés. Bien qu'Almirant n'empêche pas ce déplacement, les dépendances servent d'indicateur visuel et contextuel pour éviter le travail prématuré.

Supprimer une dépendance

1. Ouvrez la vue détaillée du work item.
2. Dans la section Dependencies, localisez la relation à supprimer.
3. Cliquez sur le bouton de suppression à côté de la dépendance.
4. Confirmez la suppression.

La relation est supprimée simultanément des deux items.

Pour les développeurs

Pour les développeurs

Outils MCP

Tool	Description	Paramètres principaux
get_work_item_dependencies	Obtient les dépendances d'un work item	workItemId
add_work_item_dependency	Crée une dépendance entre deux items	workItemId, dependsOnWorkItemId, type
remove_work_item_dependency	Supprime une dépendance	workItemId, dependsOnWorkItemId
get_dependencies_batch	Obtient les dépendances de plusieurs items à la fois	workItemIds

Exemple : ajouter une dépendance

Tool: add_work_item_dependency
Paramètres :
  workItemId: "uuid-item-bloqueado"
  dependsOnWorkItemId: "uuid-item-bloqueante"
  type: "blocked_by"

Cela établit que le premier item est bloqué par le second. La relation inverse, le second bloque le premier, est automatiquement créée.

Exemple : consulter les dépendances en lot

Tool: get_dependencies_batch
Paramètres :
  workItemIds: ["uuid-1", "uuid-2", "uuid-3", "uuid-4"]

Renvoie une map avec les dépendances de chaque item, utile pour visualiser le graphe de blocages d'un sprint complet.

Exemple : voir les dépendances d'un item

Tool: get_work_item_dependencies
Paramètres :
  workItemId: "uuid-del-item"

Renvoie deux listes :

• blocks : items que cet item bloque.
• blockedBy : items qui bloquent cet item.