update_todo_list

A ferramenta update_todo_list substitui toda a lista de TODO por uma lista de verificação atualizada que reflete o estado atual. Ela fornece o acompanhamento passo a passo das tarefas, permitindo a confirmação da conclusão antes de atualizar e a adição dinâmica de novas tarefas descobertas durante tarefas complexas.

Parâmetros

A ferramenta aceita estes parâmetros:

• todos (obrigatório): Uma lista de verificação em markdown com descrições de tarefas e indicadores de status

O Que Faz

Esta ferramenta gerencia uma lista abrangente de TODO que acompanha o progresso da tarefa através de diferentes estados de status. Ela substitui a lista inteira a cada atualização, garantindo que o estado atual reflita com precisão todas as tarefas pendentes, em andamento e concluídas. O sistema exibe a lista de TODO como lembretes em mensagens subsequentes.

Quando é usada?

• Quando as tarefas envolvem várias etapas que exigem acompanhamento sistemático
• Quando novos itens acionáveis são descobertos durante a execução da tarefa
• Ao atualizar o status de várias tarefas simultaneamente
• Quando projetos complexos se beneficiam de um acompanhamento de progresso claro e passo a passo
• Ao organizar fluxos de trabalho multifásicos com dependências

Principais Características

• Mantém uma lista de verificação em markdown de nível único com três estados de status
• Atualiza vários status de tarefas em uma única operação
• Adiciona dinamicamente novas tarefas à medida que são descobertas durante a execução
• Fornece acompanhamento visual do progresso através de indicadores de status
• Integra-se com o sistema de lembretes para visibilidade persistente da tarefa
• Suporta a reordenação de tarefas com base na prioridade de execução
• Preserva todas as tarefas inacabadas, a menos que sejam explicitamente removidas
• Permite atualizações de status em lote eficientes

Limitações

• Limitado a listas de verificação de nível único (sem aninhamento ou subtarefas)
• Não pode remover tarefas, a menos que estejam concluídas ou não sejam mais relevantes
• Requer a substituição completa da lista em vez de atualizações incrementais
• As alterações de status devem ser gerenciadas explicitamente através de chamadas de ferramentas
• Não há acompanhamento de dependência de tarefas integrado
• Não pode agendar tarefas para execução futura
• Limitado a três estados de status (pendente, em andamento, concluído)

Indicadores de Status

A ferramenta usa três indicadores de status distintos:

• [ ] Pendente: Tarefa ainda não iniciada
• [-] Em Andamento: Tarefa sendo trabalhada no momento
• [x] Concluída: Tarefa totalmente finalizada sem problemas não resolvidos

Como Funciona

Quando a ferramenta update_todo_list é invocada, ela segue este processo:

1. Validação de Status:

   • Analisa o formato da lista de verificação em markdown
   • Valida se os indicadores de status estão formatados corretamente
   • Garante que as descrições das tarefas sejam claras e acionáveis

2. Substituição da Lista:

   • Substitui completamente a lista de TODO existente
   • Preserva a ordem das tarefas conforme especificado na atualização
   • Mantém as descrições das tarefas e os estados de status

3. Integração de Lembretes:

   • Integra a lista atualizada com o sistema de lembretes
   • Exibe as tarefas atuais nos cabeçalhos das mensagens subsequentes
   • Fornece visibilidade persistente do progresso da tarefa

4. Acompanhamento do Progresso:

   • Acompanha o status de conclusão em várias atualizações
   • Mantém o histórico de tarefas para referência
   • Suporta a continuação do fluxo de trabalho entre as sessões

Melhores Práticas

Diretrizes de Gerenciamento de Tarefas

• Marque as tarefas como concluídas imediatamente após o término de todo o trabalho
• Inicie a próxima tarefa marcando-a como em andamento
• Adicione novas tarefas assim que forem identificadas durante a execução
• Use nomes de tarefas claros e descritivos que indiquem ações específicas
• Ordene as tarefas por sequência lógica de execução ou prioridade

Padrões de Atualização de Status

• Atualize vários status simultaneamente ao fazer a transição entre tarefas
• Confirme a conclusão da tarefa antes de marcá-la como finalizada
• Mantenha as tarefas em andamento focadas no trabalho atual
• Adicione tarefas de bloqueio quando dependências forem descobertas

Quando Usar

Use esta ferramenta quando:

• A tarefa envolve várias etapas ou requer acompanhamento contínuo
• Novos itens acionáveis são descobertos durante a execução da tarefa
• Várias tarefas precisam de atualizações de status simultaneamente
• Tarefas complexas se beneficiam da visualização clara do progresso

Evite usar quando:

• Há apenas uma tarefa única e trivial
• A tarefa pode ser concluída em uma ou duas etapas simples
• A solicitação é puramente conversacional ou informativa

Exemplos de Quando Usado

• Ao implementar um recurso de vários componentes que requer alterações no frontend, backend e banco de dados
• Ao depurar problemas que revelam vários problemas relacionados que exigem correções
• Ao configurar ambientes de desenvolvimento com várias etapas de configuração
• Ao documentar sistemas que exigem fases de pesquisa, escrita e revisão
• Ao refatorar código que afeta vários arquivos e requer testes

Exemplos de Uso

Divisão inicial de tarefas:

<update_todo_list>
<todos>
[-] Analisar requisitos e criar especificação técnica
[ ] Projetar esquema de banco de dados e endpoints de API
[ ] Implementar serviço de autenticação de backend
[ ] Criar componentes de login de frontend
[ ] Escrever testes abrangentes
[ ] Atualizar documentação
</todos>
</update_todo_list>

Atualizando o progresso e adicionando tarefas descobertas:

<update_todo_list>
<todos>
[x] Analisar requisitos e criar especificação técnica
[x] Projetar esquema de banco de dados e endpoints de API
[-] Implementar serviço de autenticação de backend
[ ] Criar componentes de login de frontend
[ ] Escrever testes abrangentes
[ ] Atualizar documentação
[ ] Adicionar funcionalidade de redefinição de senha
[ ] Implementar limitação de taxa para tentativas de login
</todos>
</update_todo_list>

Concluindo várias tarefas e mudando o foco:

<update_todo_list>
<todos>
[x] Analisar requisitos e criar especificação técnica
[x] Projetar esquema de banco de dados e endpoints de API
[x] Implementar serviço de autenticação de backend
[x] Criar componentes de login de frontend
[-] Escrever testes abrangentes
[ ] Atualizar documentação
[ ] Adicionar funcionalidade de redefinição de senha
[ ] Implementar limitação de taxa para tentativas de login
</todos>
</update_todo_list>