# Tareas

Tareas con responsable, horas, fechas, prioridad y comentarios, que se agendan solas en la jornada del responsable.

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

- Categoría: Proyectos y empresas
- Estado: Disponible
- Requisitos: Un proyecto con al menos una etapa; Para asignar: que el responsable sea miembro del proyecto
- Herramientas MCP (Solo leen): `listar_tareas`, `ver_tarea`, `listar_comentarios_tarea`
- Herramientas MCP (Escriben o modifican): `crear_tarea`, `editar_tarea`, `eliminar_tarea`, `editar_tareas_en_lote`, `comentar_tarea`

## ¿Qué permite hacer?

Una tarea es la unidad de trabajo de una etapa. Tiene nombre, descripción, responsable, avance, horas estimadas, fechas, horario fijo opcional, prioridad, dependencias, checklist y comentarios.

- Asignarla a un miembro del proyecto.
- Moverla a otra etapa del mismo proyecto.
- Comentarla con texto, fotos o videos, o citando adjuntos del proyecto sin volver a subirlos.
- Dejar que ArduMaker le busque día en la agenda del responsable.

## ¿Cuándo conviene usarlo?

- Para repartir trabajo con estimación de horas y ver la carga de cada persona.
- Para que las tareas aparezcan en el Google Calendar del responsable.

## ¿Cómo funciona en ArduMaker?

### Avance y columna

Sin checklist, el avance se carga a mano (0 a 100). Con al menos un ítem de checklist, se calcula solo y no se puede escribir. La columna del tablero (`estado`) es independiente: una tarea al 100% puede seguir en revisión.

### Auto-agendado

1. Si la tarea tiene responsable y horas pero no fecha, ArduMaker la ubica en el primer día con lugar en la jornada del responsable, en su zona horaria y nunca en una hora que ya pasó.
2. Entre tareas del mismo responsable, la de mayor `prioridad` se ubica primero.
3. Una tarea con fecha puesta a mano queda fija: el motor la esquiva pero no la mueve.
4. Si depende de otras tareas, no se agenda antes del día siguiente al de su dependencia.

> **INFO:** Las tareas sin horas cargadas ocupan el día completo y no participan del auto-agendado: necesitan fecha puesta a mano.

## ¿Qué cambia realmente?

- Cambiar horas, responsable, avance, dependencias o prioridad puede reacomodar otras tareas auto-agendadas de la misma persona; la respuesta lo avisa.
- Si el responsable tiene [Google Calendar](https://ardumaker.com/docs/google-calendar) conectado, sus tareas con fecha se reflejan allí en el siguiente ciclo de sincronización.
- Borrar una tarea se lleva su checklist y comentarios a la papelera y quita sus eventos de Google; al restaurarla se recrean.

## Esquema

**Una tarea nueva con horas**

```text
Tarea (responsable + horas, sin fecha)
  ↓
Auto-agendado (jornada - eventos - otras tareas)
  ↓
Día asignado (fecha_inicio / fecha_limite)
  ↓
Cola de Google (si el responsable conectó Google)
```

## Resultado esperado

La tarea aparece en su etapa, en el [calendario del proyecto](https://ardumaker.com/docs/calendario-de-proyecto) si tiene fecha, y en la agenda personal de su responsable.

## Errores y resolución

| Mensaje | Causa |
| --- | --- |
| `avance is managed automatically by the checklist for this task` | Se intentó fijar el avance de una tarea con checklist. |
| `Adding '<tarea>' as a dependency would create a cycle` | La dependencia cerraría un círculo. |

Después de mover una tarea de etapa, hay que usar la etapa que devuelve la respuesta en las llamadas siguientes.

## Relación con MCP

- Lectura: `listar_tareas` (paginado, con filtros), `ver_tarea` (descripción, checklist, dependencias y permisos) y `listar_comentarios_tarea`.
- Escritura: `crear_tarea`, `editar_tarea`, `editar_tareas_en_lote` y `comentar_tarea` (texto y referencias a adjuntos; no sube archivos).
- `eliminar_tarea` es reversible desde la papelera.

> **INFO:** En `crear_tarea`, `responsable_id` es el id del miembro del proyecto (ver `listar_miembros_proyecto`), no el id de usuario.

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

## Funciones relacionadas

- [Etapas](https://ardumaker.com/docs/etapas/)
- [Checklists](https://ardumaker.com/docs/checklists/)
- [Dependencias](https://ardumaker.com/docs/dependencias/)
- [Calendario de proyecto](https://ardumaker.com/docs/calendario-de-proyecto/)
- [Google Calendar](https://ardumaker.com/docs/google-calendar/)
- [Acuerdos a tareas](https://ardumaker.com/docs/acuerdos-a-tareas/)