Complete Issues (Linear)

Quick start

•Leer /mnt/project/project-context.md antes de iniciar.
•Si hay más de una issue → usar subagente issue-completer por cada issue.
•Seguir el workflow completo hasta "In Review".
•Crear comentario final con firma obligatoria.
•Nunca marcar "Done" sin aprobación explícita del usuario.

Decisión de arquitectura (subagentes)

code

IF cantidad_de_issues > 1 THEN
  llamar_subagente_issue_completer(issue_id) por cada issue
  consolidar_resultados()
  presentar_reporte_unificado()
ELSE
  ejecutar_workflow_directo()

Pasos no omitibles

code

1. Después de push → ejecutar `gh pr create`
2. Después de crear PR → ejecutar `update_issue(state: "In Review")`

Workflow completo

Fase 1: Inicio

code

get_issue(id)
update_issue(id, state: "In Progress")

VERIFICAR: ¿Estado == "In Progress"? [SI/NO]
IF NO → repetir update_issue
IF SI → continuar

Antes de avanzar, verificar:

•Requisitos funcionales claros
•Dependencias resueltas o documentadas
•Contexto técnico suficiente
•Si falta información → preguntar al usuario

Fase 2: Preparación Git

code

IF requiere_código THEN
  git checkout -b feature/ISSUE-ID-descripcion
ELSE
  saltar a FASE 3

Fase 3: Implementación

code

implementar_solución()

VERIFICAR: ¿Funciona correctamente? [SI/NO]
IF NO → corregir → verificar nuevamente
IF SI → continuar

Fase 4: Commit y Push

code

IF se_usó_git THEN
  git add .
  git commit -m "tipo: descripción"
  git push origin branch
  
  VERIFICAR: ¿Push exitoso? [SI/NO]
  IF NO → resolver error → reintentar
  IF SI → continuar
ELSE
  saltar a FASE 6

Fase 5: Pull Request

code

IF se_usó_git THEN
  gh pr create --title "tipo: ISSUE-ID descripción" \
               --body "Closes #ISSUE-ID" \
               --base main
  
  VERIFICAR: ¿PR creado? [SI/NO]
  IF NO → resolver error → reintentar gh pr create
  IF SI → guardar URL → continuar
ELSE
  saltar a FASE 6

Fase 6: Mover a In Review

code

update_issue(id, state: "In Review")

VERIFICAR: ¿Estado == "In Review"? [SI/NO]
IF NO → ejecutar update_issue nuevamente
IF SI → continuar

Obligatorio independientemente de si se usó Git.

Fase 7: Documentación

code

create_comment(
  issueId: id,
  body: "
    ## Trabajo Completado
    
    [descripción de cambios]
    [URL del PR si aplica]
    
    ---
    _Hecho por Cursor_
  "
)

VERIFICAR: ¿Comentario creado con firma? [SI/NO]
IF NO → crear comentario
IF SI → workflow completado

Fase 8: Esperar aprobación

code

NUNCA ejecutar update_issue(state: "Done") sin aprobación explícita del usuario

Reglas heurísticas

code

IF múltiples_issues THEN usar_subagente_issue_completer()
IF push_completado THEN ejecutar_gh_pr_create()
IF pr_creado THEN ejecutar_update_issue("In Review")
IF trabajo_terminado AND estado != "In Review" THEN ERROR
IF comentario_sin_firma THEN agregar "---\n_Hecho por Cursor_"
IF usuario_no_aprobó THEN NO ejecutar update_issue("Done")

Uso de subagente issue-completer

Patrón de invocación:

code

Usuario solicita: [DNT-101, DNT-102, DNT-103]

Detectar: 3 issues → múltiples

Ejecutar:
  FOR issue IN [DNT-101, DNT-102, DNT-103]:
    subagente.issue-completer(issue)
  END FOR

Consolidar:
  recopilar_estado_de_cada_issue()
  identificar_completados_vs_bloqueados()
  
Reportar:
  DNT-101: estado y resultado
  DNT-102: estado y resultado
  DNT-103: estado y resultado
  
  Issues que requieren atención: [lista]

Coordinación de resultados:

•Esperar completación de todos los subagentes
•Recopilar estado individual de cada issue
•Identificar issues bloqueados o con errores
•Presentar reporte consolidado
•Solicitar acción del usuario para issues bloqueados

Herramientas

Herramienta	Parámetros	Uso
`get_issue`	`id`	Obtener detalles
`update_issue`	`id`, `state`, `assignee`	Cambiar estado/asignación
`create_comment`	`issueId`, `body`	Documentar trabajo
`list_issues`	`team`, `state`, `parentId`	Buscar issues
`gh pr create`	`--title`, `--body`, `--base`	Crear PR

Verificación final

Antes de indicar trabajo completado:

code

□ ¿Múltiples issues? → ¿Se usó subagente issue-completer?
□ ¿Issue en "In Progress" al inicio?
□ ¿Implementación funcional?
□ ¿PR creado? (si Git)
□ ¿Issue en "In Review"?
□ ¿Comentario con firma creado?
□ ¿NO marcado "Done"?

Errores más frecuentes:

•No usar subagente con múltiples issues
•Olvidar gh pr create después de push
•Olvidar update_issue(state: "In Review") después de PR

Recursos

•Ejemplos: examples.md
•Referencia detallada: reference.md