DevArtsLab/linear-refinamiento-investigación

Refinamiento de Investigación en Linear

Ejecuta una pasada de investigación de calidad diaria contra un ticket de investigación activo de Linear. Objetivo predeterminado: DEV-47 (productivizar el rastreador de trabajos como SaaS multiinquilino en Cloudflare, espacio de trabajo DevArts Lab). Pasa un identificador de ticket diferente para reutilizarlo en otro ticket.

Protocolo de pasada

1. Obtén el ticket mediante linear-mcp-server (get_issue o list_issues por identificador). Lee la descripción completa y todos los comentarios primero.

2. Elige un área de enfoque: la pregunta abierta de mayor prioridad con baja confianza, o la afirmación no verificada más antigua en los hallazgos. Profundiza en un área en lugar de tocar todo.

3. Investiga con fuentes autorizadas solamente: documentos oficiales, changelogs, páginas de precios de proveedores, repos/issues aguas arriba. Usa web_search + webfetch. Registra cada URL de fuente y la fecha de verificación.

4. Actualiza el ticket en el lugar (parche save_issue):

   • Marca las afirmaciones verificadas con [verificado YYYY-MM-DD: fuente]
   • Corrige afirmaciones obsoletas o incorrectas
   • Mueve las preguntas respondidas al Registro de Decisiones con: fecha, decisión, evidencia, confianza y qué cambiaría la decisión
   • Añade nuevas preguntas abiertas descubiertas (por qué importa + prioridad)
   • Actualiza las fases/planes si la evidencia lo justifica

5. Un comentario por pasada (save_comment): área de enfoque, qué cambió, qué mirar a continuación. Señala las decisiones que requieren juicio del producto (precios, alcance, compensaciones de privacidad) al usuario en lugar de decidirlas.

6. Mantente acotado: un incremento enfocado. Las pasadas diarias se acumulan.

Reglas

• Solo investigación y actualizaciones de tickets. No modifiques código o repos.
• Nunca inventes fuentes o capacidades. Marca las afirmaciones no verificables como no verificadas con la evidencia faltante.
• Preserva la estructura del ticket; edita en el lugar, nunca reescribas por completo.
• Si cada pregunta está resuelta: reverifica las afirmaciones verificadas más antiguas (se degradan) o profundiza el plan de implementación.
• El repo del espacio de trabajo puede leerse para contexto, pero no editarse.

Programación

Se generan copias programadas por proyecto mediante agent-research-kit (~/projects/devartslab/agent-research-kit/install.sh), que renderiza templates/prompt.md.tmpl con el ID de ticket de cada proyecto. Este archivo es la referencia interactiva; la plantilla de prompt del kit es el maestro programado.