Todos

Todos são tarefas pessoais leves para capturar rapidamente coisas que não exigem um work item completo. Enquanto work items estruturam o trabalho da equipe em boards com fluxos Kanban, todos oferecem uma maneira ágil de gerenciar tarefas pessoais e lembretes.

Diferença em relação a work items

Aspecto	Todos	Work Items
Finalidade	Captura rápida de tarefas pessoais	Trabalho estruturado da equipe
Localização	Lista pessoal, opcionalmente vinculada a projeto	Colunas de um board
Estado	Campo direto (pending, in_progress, done, blocked)	Derivado da coluna do board
Hierarquia	Sem hierarquia	Epic > Feature > Story > Task
Atribuições	Um único proprietário	Vários responsáveis com papéis
Planejamento	Sem sprints	Associados a sprints

Quando usar cada um

• Todo: "Revisar o e-mail de Juan", "Ligar para o fornecedor", "Pesquisar biblioteca X".
• Work item: "Implementar endpoint de autenticação", "Projetar tela de login".

Estados

Os todos têm um campo de estado explícito com quatro valores possíveis:

Estado	Descrição
pending	Pendente, ainda não iniciado
in_progress	Em andamento, está sendo trabalhado
done	Concluído
blocked	Bloqueado por algum motivo

Ao marcar um todo como done, o sistema registra automaticamente a data de conclusão em completedAt.

Prioridade

Assim como os work items, os todos oferecem suporte a níveis de prioridade:

Prioridade	Uso recomendado
urgent	Requer atenção imediata
high	Importante, deve ser concluído em breve
medium	Prioridade normal
low	Pode esperar, sem urgência

Criar um todo

Há várias formas de criar um todo:

1. Na página Todos -- Acesse /todos e use o botão para criar um novo todo.
2. Via MCP -- Use a tool create_todo_item para criar todos programaticamente.

Campos na criação

Campo	Tipo	Descrição	Obrigatório
title	string	Título descritivo do todo	Sim
description	string	Descrição adicional, aceita Markdown	Não
priority	enum	Prioridade: urgent, high, medium, low	Não
projectId	uuid	Projeto ao qual pertence (opcional)	Não
dueDate	date	Data limite	Não
ownerUserId	uuid	Usuário proprietário do todo	Não
metadata	object	Metadados adicionais	Não

Todos globais vs. vinculados a projeto

Os todos podem existir de duas formas:

• Globais (sem projeto): Tarefas pessoais que não pertencem a nenhum projeto específico. Elas aparecem na visualização geral de todos.
• Vinculados a projeto: Tarefas associadas a um projeto. Elas aparecem tanto na visualização geral quanto filtradas por projeto.

Isso permite usar todos tanto para tarefas pessoais gerais quanto para lembretes relacionados a um projeto específico sem precisar criar um work item formal.

Comentários

Os todos oferecem suporte a comentários para adicionar notas ou atualizações:

• Adicione comentários na visualização de detalhes do todo.
• Os comentários podem ser listados usando a tool MCP list_todo_comments.
• O contador de comentários (commentCount) está disponível na visualização de lista.

Operações

Alterar estado

Você pode alterar o estado de um todo de várias formas:

• Pela interface -- Use os controles de estado na visualização de lista ou de detalhes.
• Via MCP -- Use a tool set_todo_item_status para alterar o estado programaticamente.

Definir data limite

• Pela interface -- Edite o campo de data nos detalhes do todo.
• Via MCP -- Use a tool set_todo_item_due_date.

Atribuir proprietário

Por padrão, o criador do todo é o proprietário. Você pode reatribuir um todo a outro usuário:

• Pela interface -- Selecione o novo proprietário nos detalhes do todo.
• Via MCP -- Use a tool assign_todo_item_owner.

Excluir

Ao contrário dos work items, que são arquivados, os todos podem ser excluídos permanentemente quando não forem mais necessários.

Para desenvolvedores

Para desenvolvedores

Ferramentas MCP

Gerenciamento básico

Tool	Descrição	Parâmetros principais
create_todo_item	Cria um novo todo	title, description, priority, projectId, dueDate, ownerUserId
get_todo_item	Obtém os detalhes de um todo	todoItemId
list_todo_items	Lista todos com filtros	projectId, status, priority, ownerUserId
update_todo_item	Atualiza campos de um todo	todoItemId, campos a atualizar
delete_todo_item	Exclui um todo	todoItemId

Operações específicas

Tool	Descrição	Parâmetros principais
set_todo_item_status	Altera o estado de um todo	todoItemId, status
set_todo_item_due_date	Define ou altera a data limite	todoItemId, dueDate
assign_todo_item_owner	Atribui um novo proprietário ao todo	todoItemId, ownerUserId

Comentários

Tool	Descrição	Parâmetros principais
add_todo_comment	Adiciona um comentário a um todo	todoItemId, content
list_todo_comments	Lista os comentários de um todo	todoItemId

Exemplo: Criar um 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"

Exemplo: Marcar como concluído

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

Exemplo: Listar todos pendentes de um projeto

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

Exemplo: Adicionar um comentário

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