# Etapas

Fases que agrupan tareas, con orden, dependencias, columna en el tablero y avance promedio.

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

- Categoría: Proyectos y empresas
- Estado: Disponible
- Requisitos: Un proyecto con acceso; Para crear o editar: nivel suficiente en la sección Etapas
- Herramientas MCP (Solo leen): `listar_etapas`, `ver_etapa`
- Herramientas MCP (Escriben o modifican): `crear_etapa`, `editar_etapa`, `eliminar_etapa`, `editar_etapas_en_lote`

## ¿Qué permite hacer?

Una etapa agrupa tareas de un proyecto: una fase, un entregable o un sprint. Tiene nombre, descripción, orden, dependencias y su propia columna en el tablero.

- Crear, renombrar, reordenar y borrar etapas.
- Marcar de qué otras etapas depende.
- Moverla entre columnas del tablero.
- Darle un `slug` propio, único en el proyecto entre etapas, tareas y adjuntos.

## ¿Cuándo conviene usarlo?

- Para dividir un proyecto en fases con un avance que se pueda seguir.
- Para atar un pago a un entregable desde la [gestión económica](https://ardumaker.com/docs/gestion-economica).

## ¿Cómo funciona en ArduMaker?

- El avance de una etapa es el promedio simple del avance de sus tareas.
- Si nadie marcó dependencias a mano, el tablero las deduce de las tareas: si una tarea de esta etapa depende de otra de otra etapa, esta etapa espera a aquella.
- Una dependencia que armaría un ciclo se rechaza.
- Borrar una etapa se lleva sus tareas, checklists y comentarios a la papelera como una sola entrada.

## ¿Qué cambia realmente?

- Crear o editar una etapa escribe una línea en el historial del proyecto.
- Borrarla es reversible durante 30 días desde la papelera.

## Resultado esperado

La etapa aparece en el tablero con su avance, su columna y la marca `puede_completarse`, que es verdadera cuando todas sus dependencias están al 100%.

## Errores y resolución

| Mensaje | Causa |
| --- | --- |
| `Adding '<etapa>' as a dependency would create a cycle` | La dependencia cerraría un círculo entre etapas. |

Si se borró una etapa por error, se restaura desde la papelera; sus tareas vuelven con ella.

## Relación con MCP

- Lectura: `listar_etapas` (paginado, filtra por columna) y `ver_etapa` (incluye sus tareas y el bloque `permisos`).
- Escritura: `crear_etapa`, `editar_etapa` y `editar_etapas_en_lote` (hasta 100 elementos por llamada, cada uno con su resultado).
- `eliminar_etapa` es reversible: devuelve un `operacion_id` para `restaurar_papelera`.

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

## Funciones relacionadas

- [Proyectos y tablero kanban](https://ardumaker.com/docs/proyectos-kanban/)
- [Tareas](https://ardumaker.com/docs/tareas/)
- [Dependencias](https://ardumaker.com/docs/dependencias/)
- [Checklists](https://ardumaker.com/docs/checklists/)
- [Papelera](https://ardumaker.com/docs/papelera/)