Todos

Les todos sont des tâches personnelles légères conçues pour capturer rapidement ce qui ne nécessite pas un work item complet. Alors que les work items sont conçus pour du travail structuré dans des boards avec des workflows Kanban, les todos proposent une manière plus agile de gérer les tâches personnelles et les rappels.

Différence avec les work items

Aspect	Todos	Work Items
Objectif	Capture rapide de tâches personnelles	Travail d'équipe structuré
Emplacement	Liste personnelle, facultativement liée à un projet	Colonnes d'un board
État	Champ direct (pending, in_progress, done, blocked)	Dérivé de la colonne du board
Hiérarchie	Sans hiérarchie	Epic > Feature > Story > Task
Assignations	Un seul propriétaire	Plusieurs personnes assignées avec des rôles
Planification	Sans sprints	Associés aux sprints

Quand utiliser chacun

• Todo : « Vérifier l'e-mail de Jean », « Appeler le fournisseur », « Rechercher la bibliothèque X ».
• Work item : « Implémenter l'endpoint d'authentification », « Concevoir l'écran de connexion ».

États

Les todos disposent d'un champ d'état explicite avec quatre valeurs possibles :

État	Description
pending	En attente, pas encore commencé
in_progress	En cours, le travail est en cours
done	Terminé
blocked	Bloqué pour une raison quelconque

Lorsqu'un todo est marqué comme done, le système enregistre automatiquement la date de complétion dans completedAt.

Priorité

Comme les work items, les todos prennent en charge des niveaux de priorité :

Priorité	Utilisation recommandée
urgent	Demande une attention immédiate
high	Important, doit être terminé rapidement
medium	Priorité normale
low	Peut attendre, sans urgence

Créer un todo

Il existe plusieurs façons de créer un todo :

1. Depuis la page Todos -- Accédez à /todos et utilisez le bouton pour créer un nouveau todo.
2. Via MCP -- Utilisez le tool create_todo_item pour créer des todos par programmation.

Champs à la création

Champ	Type	Description	Obligatoire
title	string	Titre descriptif du todo	Oui
description	string	Description supplémentaire, accepte Markdown	Non
priority	enum	Priorité : urgent, high, medium, low	Non
projectId	uuid	Projet auquel il appartient, facultatif	Non
dueDate	date	Date limite	Non
ownerUserId	uuid	Utilisateur propriétaire du todo	Non
metadata	object	Métadonnées supplémentaires	Non

Todos globaux ou liés à un projet

Les todos peuvent exister sous deux formes :

• Globaux, sans projet : tâches personnelles n'appartenant à aucun projet particulier. Elles apparaissent dans la vue générale des todos.
• Liés à un projet : tâches liées à un projet. Elles apparaissent dans la vue générale et lorsqu'elles sont filtrées par projet.

Vous pouvez donc utiliser les todos tant pour des tâches personnelles générales que pour des rappels liés à un projet particulier sans créer de work item formel.

Commentaires

Les todos prennent en charge les commentaires pour ajouter des notes ou mises à jour :

• Ajoutez des commentaires depuis la vue détaillée du todo.
• Les commentaires peuvent être listés avec le tool MCP list_todo_comments.
• Le compteur de commentaires (commentCount) est disponible dans la vue de liste.

Opérations

Changer l'état

Vous pouvez modifier l'état d'un todo de plusieurs façons :

• Depuis l'interface -- Utilisez les contrôles d'état dans la vue de liste ou le détail.
• Via MCP -- Utilisez le tool set_todo_item_status pour changer l'état par programmation.

Définir une date limite

• Depuis l'interface -- Modifiez le champ de date dans le détail du todo.
• Via MCP -- Utilisez le tool set_todo_item_due_date.

Assigner un propriétaire

Par défaut, le créateur du todo en est le propriétaire. Vous pouvez réassigner un todo à un autre utilisateur :

• Depuis l'interface -- Sélectionnez le nouveau propriétaire dans le détail du todo.
• Via MCP -- Utilisez le tool assign_todo_item_owner.

Supprimer

Contrairement aux work items qui sont archivés, les todos peuvent être définitivement supprimés lorsqu'ils ne sont plus nécessaires.

Pour les développeurs

Pour les développeurs

Outils MCP

Gestion de base

Tool	Description	Paramètres principaux
create_todo_item	Crée un nouveau todo	title, description, priority, projectId, dueDate, ownerUserId
get_todo_item	Obtient les détails d'un todo	todoItemId
list_todo_items	Liste les todos avec des filtres	projectId, status, priority, ownerUserId
update_todo_item	Met à jour les champs d'un todo	todoItemId, champs à mettre à jour
delete_todo_item	Supprime un todo	todoItemId

Opérations spécifiques

Tool	Description	Paramètres principaux
set_todo_item_status	Change l'état d'un todo	todoItemId, status
set_todo_item_due_date	Définit ou modifie la date limite	todoItemId, dueDate
assign_todo_item_owner	Assigne un nouveau propriétaire au todo	todoItemId, ownerUserId

Commentaires

Tool	Description	Paramètres principaux
add_todo_comment	Ajoute un commentaire à un todo	todoItemId, content
list_todo_comments	Liste les commentaires du todo	todoItemId

Exemple : créer un todo

Tool: create_todo_item
Paramètres :
  title: "Vérifier la proposition du client"
  description: "Lire et répondre à la proposition envoyée par e-mail"
  priority: "high"
  dueDate: "2026-03-25"

Exemple : marquer comme terminé

Tool: set_todo_item_status
Paramètres :
  todoItemId: "uuid-del-todo"
  status: "done"

Exemple : lister les todos en attente d'un projet

Tool: list_todo_items
Paramètres :
  projectId: "uuid-del-proyecto"
  status: "pending"

Exemple : ajouter un commentaire

Tool: add_todo_comment
Paramètres :
  todoItemId: "uuid-del-todo"
  content: "Le client a confirmé qu'il enverra une version révisée demain"