# Tarefas

Tarefas com responsável, horas, datas, prioridade e comentários, que se agendam sozinhas no horário do responsável.

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

- Categoria: Projetos e empresas
- Estado: Disponível
- Requisitos: Um projeto com pelo menos uma etapa; Para atribuir: o responsável tem de ser membro do projeto
- Ferramentas MCP (Só leem): `listar_tareas`, `ver_tarea`, `listar_comentarios_tarea`
- Ferramentas MCP (Escrevem ou modificam): `crear_tarea`, `editar_tarea`, `eliminar_tarea`, `editar_tareas_en_lote`, `comentar_tarea`

## O que permite fazer?

Uma tarefa é a unidade de trabalho de uma etapa. Tem nome, descrição, responsável, avanço, horas estimadas, datas, horário fixo opcional, prioridade, dependências, checklist e comentários.

- Atribuí-la a um membro do projeto.
- Movê-la para outra etapa do mesmo projeto.
- Comentá-la com texto, fotos ou vídeos, ou citando anexos do projeto sem os voltar a enviar.
- Deixar que a ArduMaker lhe encontre um dia na agenda do responsável.

## Quando convém usar?

- Para distribuir trabalho com estimativa de horas e ver a carga de cada pessoa.
- Para que as tarefas apareçam no Google Calendar do responsável.

## Como funciona na ArduMaker?

### Avanço e coluna

Sem checklist, o avanço é definido manualmente (0 a 100). Com pelo menos um item de checklist, é calculado e não se pode escrever. A coluna do quadro (`estado`) é independente: uma tarefa a 100% pode continuar em revisão.

### Agendamento automático

1. Se a tarefa tiver responsável e horas mas não data, a ArduMaker coloca-a no primeiro dia com espaço no horário do responsável, no seu fuso horário e nunca em uma hora já passada.
2. Entre tarefas do mesmo responsável, a de maior `prioridad` é colocada primeiro.
3. Uma tarefa com data definida manualmente fica fixa: o motor contorna-a mas não a move.
4. Se depender de outras tarefas, não é agendada antes do dia seguinte ao da dependência.

> **INFO:** As tarefas sem horas ocupam o dia inteiro e não participam no agendamento automático: precisam de data definida manualmente.

## O que muda realmente?

- Mudar horas, responsável, avanço, dependências ou prioridade pode reorganizar outras tarefas agendadas automaticamente da mesma pessoa; a resposta avisa.
- Se o responsável tiver o [Google Calendar](https://ardumaker.com/pt/docs/google-calendar) ligado, as tarefas com data refletem-se lá no ciclo de sincronização seguinte.
- Apagar uma tarefa leva a checklist e os comentários para a lixeira e remove os eventos do Google; ao restaurá-la são recriados.

## Esquema

**Uma tarefa nova com horas**

```text
Tarefa (responsável + horas, sem data)
  ↓
Agendamento automático (horário - eventos - outras tarefas)
  ↓
Dia atribuído (fecha_inicio / fecha_limite)
  ↓
Fila do Google (se o responsável ligou o Google)
```

## Resultado esperado

A tarefa aparece na sua etapa, no [calendário do projeto](https://ardumaker.com/pt/docs/calendario-de-proyecto) se tiver data, e na agenda pessoal do responsável.

## Erros e resolução

| Mensagem | Causa |
| --- | --- |
| `avance is managed automatically by the checklist for this task` | Tentou-se fixar o avanço de uma tarefa com checklist. |
| `Adding '<tarea>' as a dependency would create a cycle` | A dependência fecharia um círculo. |

Depois de mover uma tarefa de etapa, use a etapa devolvida na resposta nas chamadas seguintes.

## Relação com MCP

- Leitura: `listar_tareas` (paginado, com filtros), `ver_tarea` (descrição, checklist, dependências e permissões) e `listar_comentarios_tarea`.
- Escrita: `crear_tarea`, `editar_tarea`, `editar_tareas_en_lote` e `comentar_tarea` (texto e referências a anexos; não envia arquivos).
- `eliminar_tarea` é reversível a partir da lixeira.

> **INFO:** Em `crear_tarea`, `responsable_id` é o id do membro do projeto (ver `listar_miembros_proyecto`), não o id de usuário.

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

## Funcionalidades relacionadas

- [Etapas](https://ardumaker.com/pt/docs/etapas/)
- [Checklists](https://ardumaker.com/pt/docs/checklists/)
- [Dependências](https://ardumaker.com/pt/docs/dependencias/)
- [Calendário de projeto](https://ardumaker.com/pt/docs/calendario-de-proyecto/)
- [Google Calendar](https://ardumaker.com/pt/docs/google-calendar/)
- [Acordos para tarefas](https://ardumaker.com/pt/docs/acuerdos-a-tareas/)