# Checklists

Passos dentro de uma tarefa que calculam o avanço sozinhos e podem citar anexos do projeto.

Fonte: https://ardumaker.com/pt/docs/checklists/

- Categoria: Projetos e empresas
- Estado: Disponível
- Requisitos: Uma tarefa existente; Nível suficiente na seção Tarefas
- Ferramentas MCP (Só leem): `listar_checklist_items`
- Ferramentas MCP (Escrevem ou modificam): `agregar_checklist_item`, `editar_checklist_item`, `eliminar_checklist_item`, `editar_checklist_en_lote`

## O que permite fazer?

- Adicionar itens de até 300 caracteres a uma tarefa.
- Marcá-los como feitos, editá-los, reordená-los ou apagá-los.
- Citar anexos do projeto a partir de um item, sem duplicar o arquivo.

## Quando convém usar?

- Para dividir uma tarefa em passos verificáveis.
- Para que o avanço da tarefa reflita o que foi feito sem o definir manualmente.

## Como funciona na ArduMaker?

Com pelo menos um item, o avanço da tarefa passa a ser `feitos / total * 100` e recalcula-se sempre que um item é adicionado, marcado ou apagado. Essa mudança sobe ao avanço da etapa e do projeto, e pode mover o cartão de coluna se ninguém o fixou.

## O que muda realmente?

- Cada item marcado deixa uma linha no histórico do projeto.
- Apagar um item é reversível durante 30 dias a partir da lixeira.

## Resultado esperado

A tarefa mostra a checklist por ordem e um avanço que já não se edita manualmente.

## Erros e resolução

- Se se tentar fixar o avanço de uma tarefa com checklist, a API responde `avance is managed automatically by the checklist for this task`.
- Nas operações em lote cada elemento aplica-se separadamente: um que falha não desfaz os outros. Reveja `resultados` antes de repetir.

## Relação com MCP

- Leitura: `listar_checklist_items`.
- Escrita: `agregar_checklist_item`, `editar_checklist_item` e `editar_checklist_en_lote` (até 100 elementos).
- `eliminar_checklist_item` é um apagamento reversível.

Mais em [/mcp/proyectos](https://ardumaker.com/pt/mcp/proyectos) e [/mcp/docs](https://ardumaker.com/pt/mcp/docs).

## Funcionalidades relacionadas

- [Tarefas](https://ardumaker.com/pt/docs/tareas/)
- [Anexos](https://ardumaker.com/pt/docs/archivos-adjuntos/)
- [Etapas](https://ardumaker.com/pt/docs/etapas/)
- [Projetos e quadro kanban](https://ardumaker.com/pt/docs/proyectos-kanban/)