# Checklists

Pasos dentro de una tarea que calculan su avance solos y pueden citar adjuntos del proyecto.

Fuente: https://ardumaker.com/docs/checklists/

- Categoría: Proyectos y empresas
- Estado: Disponible
- Requisitos: Una tarea existente; Nivel suficiente en la sección Tareas
- Herramientas MCP (Solo leen): `listar_checklist_items`
- Herramientas MCP (Escriben o modifican): `agregar_checklist_item`, `editar_checklist_item`, `eliminar_checklist_item`, `editar_checklist_en_lote`

## ¿Qué permite hacer?

- Agregar ítems de hasta 300 caracteres a una tarea.
- Marcarlos como hechos, editarlos, reordenarlos o borrarlos.
- Citar adjuntos del proyecto desde un ítem, sin duplicar el archivo.

## ¿Cuándo conviene usarlo?

- Para partir una tarea en pasos verificables.
- Para que el avance de la tarea refleje lo hecho sin cargarlo a mano.

## ¿Cómo funciona en ArduMaker?

Con al menos un ítem, el avance de la tarea pasa a ser `hechos / total * 100` y se recalcula cada vez que se agrega, marca o borra un ítem. Ese cambio sube al avance de la etapa y del proyecto, y puede mover la tarjeta de columna si nadie la fijó a mano.

## ¿Qué cambia realmente?

- Cada ítem marcado deja una línea en el historial del proyecto.
- Borrar un ítem es reversible durante 30 días desde la papelera.

## Resultado esperado

La tarea muestra su checklist en orden y un avance que ya no se edita a mano.

## Errores y resolución

- Si se intenta fijar el avance de una tarea que tiene checklist, la API responde `avance is managed automatically by the checklist for this task`.
- En las operaciones en lote cada elemento se aplica por separado: uno que falla no deshace los demás. Conviene revisar `resultados` antes de reintentar.

## Relación con MCP

- Lectura: `listar_checklist_items`.
- Escritura: `agregar_checklist_item`, `editar_checklist_item` y `editar_checklist_en_lote` (hasta 100 elementos).
- `eliminar_checklist_item` es un borrado reversible.

Más en [/mcp/proyectos](https://ardumaker.com/mcp/proyectos) y [/mcp/docs](https://ardumaker.com/mcp/docs).

## Funciones relacionadas

- [Tareas](https://ardumaker.com/docs/tareas/)
- [Archivos adjuntos](https://ardumaker.com/docs/archivos-adjuntos/)
- [Etapas](https://ardumaker.com/docs/etapas/)
- [Proyectos y tablero kanban](https://ardumaker.com/docs/proyectos-kanban/)