Épicas

Para qué sirve

Las épicas son piezas de trabajo (título + notas enriquecidas) con un directorio de apéndices y una lista de tareas vinculadas de los proyectos. El progreso es el porcentaje de esas tareas completadas.

Requisitos

En cada proyecto del alcance:

Una sección llamada Épicas.
Un custom field de texto _Epic (la app lo crea o adjunta sola si tenés permisos).

Ver Configuración de Asana.

Cómo se usa

Elegir proyectos (alcance)

En Épicas, tocá Proyectos.
Elegí workspace y uno o más proyectos.
El alcance se guarda en este navegador.

Si nunca elegiste alcance, la app puede copiar el del primer tablero guardado.

Lista de épicas

Ves cada épica con su progreso (completadas / total).
Nueva épica crea una tarea en la sección Épicas.
Tocá una épica para abrir el detalle.

Detalle (`/epicas/{gid}`)

Izquierda: título y descripción (HTML). Editar / guardar / cancelar; abrir en Asana; eliminar. Para diagramas ASCII o texto con espacios fijos, usá el botón de bloque de código / preformateado (así se conserva el formato al guardar en Asana).
Derecha:
- Apéndices: directorio (descripción general + secciones).
- Tareas: lista de trabajo vinculadas, con chips de status/deploy.
Podés vincular una tarea existente, crear una nueva (no en la sección Épicas), desvincular o abrir el detalle de la tarea. Ese detalle es el mismo que en el tablero: sección, status, labels (Type, Team, Deploy, etc.), descripción, comentarios, subtareas y Open with Cursor (mismo comportamiento que en Tableros).

Apéndices

Overview: /epicas/{gid}/documentos (descripción general).
Sección: /epicas/{gid}/documentos/{sectionGid}.
Los apéndices son subtareas de la épica en Asana.
Las tareas de trabajo no son subtareas: se vinculan con el campo _Epic.

Tablero de la épica

En /epicas/{gid}/tablero ves un kanban filtrado al alcance de proyectos de esa épica (mismo componente de tablero, con defaults de Status + agrupación por asignado). Desde ahí volvés al detalle de la épica.

Eliminar una épica

Se borra la tarea-épica en Asana.
A las tareas hijas solo se les limpia el campo _Epic.
No se borran las tareas de trabajo.

Saberes clave

Progreso = tareas completadas ÷ total de vinculadas. Sin story points ni estimaciones. Si no hay tareas, no hay porcentaje.
Solo cuentan las hijas en los proyectos del alcance. Si una tarea está en otro proyecto, no aparece.
Completadas hace más de 90 días pueden no entrar en las listas (misma ventana que el tablero).
Vincular = escribir el GID de la épica en _Epic. Desvincular = vaciar ese campo.

Problemas comunes

Síntoma	Qué hacer
“Elegí proyectos”	Configurá el alcance con Proyectos.
“Sin épicas todavía”	Creá una, o verificá que exista la sección Épicas.
No se puede crear épica	Falta la sección Épicas en el proyecto.
Progreso en 0 con tareas hechas	Están fuera del alcance, o no tienen `_Epic` apuntando a esta épica.
Apéndice no encontrado	La sección se borró; volvé al overview de apéndices.

Seguí con Cargar Horas o el índice.