Saltar a contenido

Issues (Jira y Linear)

Chronos convierte un ticket directamente en una sesión. Con un tracker vinculado, el workspace gana el botón Execute issue: eliges un ticket y la sesión arranca ya sembrada con él, con la referencia externa registrada de punta a punta en la auditoría.

La configuración se hace una vez y no pasa por esta página: un administrador registra el conector (Jira o Linear) con su credencial en el panel, como se explica en Conectores. El workspace lo vincula por id y fija el proyecto o el equipo en su configuración: ver Configuración.

La credencial nunca la ve el agente ni toca tu repositorio. Chronos consulta el tracker por ti con el token que guarda el panel; tú y el agente solo veis los datos del issue.

Execute issue

Pulsa Execute issue en el panel de sesiones:

  • El selector lista los tickets del proyecto o equipo vinculado, con buscador por título y descripción.
  • El ámbito se aplica de verdad: el selector solo ve ese proyecto o equipo y no puede enumerar nada fuera.
  • Elige un ticket y Chronos prepara el brief de la sesión: clave, estado, descripción y enlace, más la instrucción extra que quieras añadir.

El brief y «Enriquecer con IA»

Antes de crear la sesión puedes editar el brief. El botón Enriquecer con IA lo afina: completa el contexto y los criterios de aceptación a partir del ticket y del repositorio, para que el agente arranque con una tarea precisa en vez de un ticket escueto. Revisa el resultado, ajústalo y crea.

La sesión queda enlazada al ticket: la referencia se muestra en la sesión y la auditoría registra qué issue fue, nunca el token.

Crear y mover issues desde la sesión

Con un tracker vinculado, el agente también puede escribir en él a mitad de conversación («añade esto como issue», «muévelo a In Review»). Dos herramientas:

  • create_issue: crea un issue en el equipo vinculado, con título y descripción opcional.
  • move_issue: mueve un issue existente (por ejemplo ENG-42) a un estado por nombre (In Review, Done).

Escribir en un sistema externo es un efecto secundario, así que Chronos nunca lo hace por iniciativa del agente: cada escritura te pide autorización primero, el mismo gate que un merge dirigido por el agente. Si la rechazas, la herramienta lo informa y el agente no reintenta por su cuenta. Las autorizaciones pendientes aparecen también en la cola de atención.

El gobierno es el mismo que en las lecturas: la escritura la ejecuta Chronos con la credencial del panel (el agente nunca ve un token ni alcanza el tracker), el issue debe estar en el equipo vinculado y la auditoría registra la escritura.

Permisos de escritura

La credencial que el administrador puso en el panel necesita ámbito de escritura: una clave de Linear de solo lectura da un error claro, nunca un fallo raro. Hoy las escrituras funcionan en Linear; en Jira aún no.

Notas

  • Las claves de Jira son del tipo PROJ-123; los identificadores de Linear, ENG-42.
  • Búsqueda: en Jira, el filtro guardado del workspace más texto libre; en Linear, el equipo más una coincidencia de texto en título y descripción.