Todos

Los todos son tareas personales ligeras pensadas para capturar rapidamente cosas que no necesitan un work item completo. Mientras que los work items estan disenados para trabajo estructurado dentro de boards con flujos Kanban, los todos ofrecen una forma mas agil de gestionar tareas personales y recordatorios.

Diferencia con work items

Aspecto	Todos	Work Items
Proposito	Captura rapida de tareas personales	Trabajo estructurado de equipo
Ubicacion	Lista personal, opcionalmente asociados a proyecto	Columnas de un board
Estado	Campo directo (pending, in_progress, done, blocked)	Derivado de la columna del board
Jerarquia	Sin jerarquia	Epic > Feature > Story > Task
Asignaciones	Un solo dueno	Multiples asignados con roles
Planificacion	Sin sprints	Asociados a sprints

Cuando usar cada uno

• Todo: "Revisar el email de Juan", "Llamar al proveedor", "Investigar libreria X".
• Work item: "Implementar endpoint de autenticacion", "Disenar pantalla de login".

Estados

Los todos tienen un campo de estado explicito con cuatro valores posibles:

Estado	Descripcion
pending	Pendiente, aun no iniciado
in_progress	En progreso, se esta trabajando en el
done	Completado
blocked	Bloqueado por alguna razon

Al marcar un todo como done, el sistema registra automaticamente la fecha de completado en completedAt.

Prioridad

Al igual que los work items, los todos soportan niveles de prioridad:

Prioridad	Uso recomendado
urgent	Requiere atencion inmediata
high	Importante, debe completarse pronto
medium	Prioridad normal
low	Puede esperar, sin urgencia

Crear un todo

Existen varias formas de crear un todo:

1. Desde la pagina de Todos -- Accede a /todos y usa el boton de crear nuevo todo.
2. Via MCP -- Usa el tool create_todo_item para crear todos programaticamente.

Campos al crear

Campo	Tipo	Descripcion	Obligatorio
title	string	Titulo descriptivo del todo	Si
description	string	Descripcion adicional, acepta Markdown	No
priority	enum	Prioridad: urgent, high, medium, low	No
projectId	uuid	Proyecto al que pertenece (opcional)	No
dueDate	date	Fecha limite	No
ownerUserId	uuid	Usuario dueno del todo	No
metadata	object	Metadatos adicionales	No

Todos globales vs. asociados a proyecto

Los todos pueden existir de dos formas:

• Globales (sin proyecto): Tareas personales que no pertenecen a ningun proyecto especifico. Aparecen en la vista general de todos.
• Asociados a proyecto: Tareas vinculadas a un proyecto. Aparecen tanto en la vista general como filtrados por proyecto.

Esto permite usar todos tanto para tareas personales generales como para recordatorios relacionados con un proyecto especifico sin necesidad de crear un work item formal.

Comentarios

Los todos soportan comentarios para agregar notas o actualizaciones:

• Agrega comentarios desde la vista de detalle del todo.
• Los comentarios se pueden listar usando el tool MCP list_todo_comments.
• El contador de comentarios (commentCount) esta disponible en la vista de lista.

Operaciones

Cambiar estado

Puedes cambiar el estado de un todo de varias formas:

• Desde la interfaz -- Usa los controles de estado en la vista de lista o detalle.
• Via MCP -- Usa el tool set_todo_item_status para cambiar el estado programaticamente.

Establecer fecha limite

• Desde la interfaz -- Edita el campo de fecha en el detalle del todo.
• Via MCP -- Usa el tool set_todo_item_due_date.

Asignar dueno

Por defecto, el creador del todo es el dueno. Puedes reasignar un todo a otro usuario:

• Desde la interfaz -- Selecciona el nuevo dueno en el detalle del todo.
• Via MCP -- Usa el tool assign_todo_item_owner.

Eliminar

A diferencia de los work items que se archivan, los todos se pueden eliminar permanentemente cuando ya no son necesarios.

Para developers

Para Developers

Herramientas MCP

Gestion basica

Tool	Descripcion	Parametros principales
create_todo_item	Crea un nuevo todo	title, description, priority, projectId, dueDate, ownerUserId
get_todo_item	Obtiene los detalles de un todo	todoItemId
list_todo_items	Lista todos con filtros	projectId, status, priority, ownerUserId
update_todo_item	Actualiza campos de un todo	todoItemId, campos a actualizar
delete_todo_item	Elimina un todo	todoItemId

Operaciones especificas

Tool	Descripcion	Parametros principales
set_todo_item_status	Cambia el estado de un todo	todoItemId, status
set_todo_item_due_date	Establece o modifica la fecha limite	todoItemId, dueDate
assign_todo_item_owner	Asigna un nuevo dueno al todo	todoItemId, ownerUserId

Comentarios

Tool	Descripcion	Parametros principales
add_todo_comment	Agrega un comentario a un todo	todoItemId, content
list_todo_comments	Lista los comentarios de un todo	todoItemId

Ejemplo: Crear un todo

Tool: create_todo_item
Parametros:
  title: "Revisar propuesta de cliente"
  description: "Leer y responder la propuesta enviada por email"
  priority: "high"
  dueDate: "2026-03-25"

Ejemplo: Marcar como completado

Tool: set_todo_item_status
Parametros:
  todoItemId: "uuid-del-todo"
  status: "done"

Ejemplo: Listar todos pendientes de un proyecto

Tool: list_todo_items
Parametros:
  projectId: "uuid-del-proyecto"
  status: "pending"

Ejemplo: Agregar un comentario

Tool: add_todo_comment
Parametros:
  todoItemId: "uuid-del-todo"
  content: "Cliente confirmo que enviara version revisada manana"