Sub-issues
Qué son los sub-issues, cuándo crearlos y cómo se relacionan con el issue padre.
Qué es un sub-issue
Un sub-issue representa un paso técnico concreto dentro de la implementación de un issue. No tiene valor independiente para el usuario — es la descomposición interna del trabajo de desarrollo.
Un sub-issue no debe existir sin un issue padre. Si el trabajo es independiente, debe ser un issue propio.
Cuándo crear sub-issues
Crear sub-issues cuando: el issue toca más de una capa del sistema (ej. front + back, back + DB), cuando hay más de un desarrollador involucrado, o cuando la estimación supera un día de trabajo.
Para issues medianas de un solo desarrollador en uno o dos días, los sub-issues son opcionales — un checklist en el description del issue puede ser suficiente.
Evitar sub-issues en ajustes, fast tracks y bugs simples.
Quién crea los sub-issues
Los sub-issues los genera el desarrollador asignado durante la planificación técnica, generalmente con apoyo de herramientas de IA en modo plan. El desarrollador revisa y ajusta la propuesta. El Líder técnico valida la descomposición antes de arrancar.
Relación con el issue padre
El estado del issue padre se deriva del estado de sus sub-issues. Un issue padre no puede marcarse como completado si tiene sub-issues abiertos. El responsable del issue padre coordina y hace seguimiento de los sub-issues hijos.