Cómo funciona

Describe el cambio. RefineBrief investiga el código y prepara los tickets de Jira.

Indicas el problema y eliges dónde investigar. RefineBrief recorre los repositorios Java conectados, encuentra clases, métodos, flujos y dependencias probablemente afectados, separa evidencia de inferencias y prepara un brief técnico con uno o varios tickets. El equipo revisa todo antes de crearlo en Jira.

Ver un ejemplo completo

Git de solo lectura · Sin cambios de código · Creación en Jira solo tras aprobación

ENTRADADescripción del cambio o problema
INVESTIGACIÓNImpacto probable y decisiones pendientes
RESULTADOBrief técnico y tickets de Jira sugeridos

Configuración inicial

Conecta una vez. Investiga siempre con el contexto actualizado.

Durante la configuración, el equipo conecta repositorios Git con acceso de solo lectura y define el proyecto y la plantilla de tickets de Jira. RefineBrief crea una representación técnica derivada y la mantiene actualizada cuando cambian los repositorios.

CONFIGURACIÓN INICIAL
  • Conectar repositorios Git
  • Conectar Jira
  • Elegir el proyecto
  • Configurar la plantilla de ticket
PARA CADA SOLICITUD
  • Describir el problema
  • Elegir algunos o todos los repositorios
  • Investigar el impacto probable
  • Revisar el brief técnico
  • Crear los tickets aprobados
Mapa técnico actualizadoILUSTRATIVO
customer-apirepositorioNotificationServiceservicioPOST /notifycontrato HTTPcustomer.eventsKafka topicsendEmail()métodoshared-domaindependencia
RUTA DE EVIDENCIA VISIBLENotificationController.java:84
CONSUMIDO POREmailConsumer.java:112

Flujo principal

De la solicitud a Jira.

  1. 01

    Describir el cambio

    Introduce un bug, una funcionalidad, una tarea o una pregunta técnica, aunque la descripción esté incompleta.

  2. 02

    Elegir dónde investigar

    Selecciona los repositorios probables o permite que RefineBrief investigue todos los conectados.

  3. 03

    Revisar el impacto probable

    Consulta el comportamiento actual, las clases, los métodos, los servicios, los flujos, las dependencias, los riesgos y las decisiones pendientes.

  4. 04

    Ajustar el resultado

    Edita el brief, responde a las preguntas y une, divide o elimina los tickets sugeridos.

  5. 05

    Crear en Jira

    Los tickets aprobados usan el proyecto y la plantilla de tickets de Jira configurados por tu equipo.

El resultado

Lo que recibe tu equipo antes del refinamiento.

RefineBrief transforma la solicitud inicial en un brief técnico revisable.

El brief incluye la solicitud original, el comportamiento actual encontrado en el código, las clases y servicios probablemente afectados, los flujos HTTP y Kafka, la evidencia vinculada, el impacto probable entre repositorios, el alcance, las dependencias, los riesgos, las preguntas abiertas y uno o varios tickets sugeridos.

RefineBriefLISTO PARA REVISAR
SOLICITUD ORIGINAL

«Añadir gestión de reintentos al procesamiento de notificaciones al cliente».

COMPORTAMIENTO ACTUAL ENCONTRADO

El productor envía eventos a customer.events. El consumidor trata los fallos temporales y permanentes del proveedor en el mismo flujo.

IMPACTO PROBABLE
  • notification-service
  • email-consumer
  • Observability
  • Pruebas de integración
EVIDENCIA
  • NotificationController.java:84
  • NotificationService.java:136
  • EmailConsumer.java:112
DECISIONES PENDIENTES
  • ¿Cuántos intentos deben realizarse?
  • ¿Deben los fallos permanentes ir a un tema de mensajes no procesados?
  • ¿Debe el consumidor garantizar la idempotencia?
  • ¿Quién recibe una alerta cuando fallan todos los intentos?
TICKETS SUGERIDOS
  • Actualizar la política de reintentos
  • Añadir idempotencia al consumidor
  • Monitorizar los fallos permanentes
  • Cubrir entregas duplicadas en las pruebas de integración
La evidencia permanece vinculadaNada llega a Jira antes de la aprobación

Impacto probable entre repositorios

Sigue el cambio más allá del primer repositorio.

RefineBrief sigue llamadas HTTP, eventos Kafka y dependencias compartidas para mostrar dónde puede repercutir un cambio. Cada relación permanece vinculada a la evidencia encontrada y puede revisarla el equipo.

APIcustomer-apiHTTP POST
SVCnotification-serviceProducer
KFKcustomer.eventsKafka topic
JOBemail-consumerConsumer
OBSobservability + testsDownstream

Evidencia, inferencia y decisión

Lo encontrado no se mezcla con lo que el equipo aún debe decidir.

Evidencia · Encontrada en el código

EmailConsumer.java gestiona los errores temporales y permanentes del proveedor en la misma rama.

Inferencia · Conclusión probable

La política de reintentos puede requerir cambios en más de un servicio.

Pregunta abierta · Decisión del equipo

¿Deben los eventos con fallo permanente pasar a un tópico dead-letter?

Una solicitud, uno o varios tickets

Revisa la división sugerida antes de que algo llegue a Jira.

Cuando la investigación encuentra trabajos independientes en servicios, consumidores, observabilidad o pruebas, RefineBrief sugiere una división. El equipo puede unir, separar, editar o eliminar cualquier ticket.

RB-249

Actualizar la política de reintentos del productor de notificaciones

notification-service

Feature
RB-250

Añadir idempotencia al consumidor de Kafka

email-consumer

Task
RB-251

Añadir monitoreo de eventos fallidos

observability

Task
RB-252

Ampliar la cobertura de integración para entregas duplicadas

integration-tests

Test

División sugerida · Unir, separar, editar o eliminar antes de crear en Jira

01

RefineBrief sugiere la división

02

El equipo revisa y edita

03

Se aplica la plantilla de tickets de Jira

04

Solo se crean los tickets aprobados

Alcance actual

Centrado en sistemas Java modernos.

RefineBrief admite actualmente Java 17 a Java 25, monolitos y microservicios, varios repositorios Git, clases, métodos y dependencias, contratos HTTP, productores y consumidores Kafka, y la selección de algunos o todos los repositorios conectados.

COMPATIBLE
  • Java 17 a Java 25
  • Monolitos y microservicios
  • Varios repositorios Git
  • Clases, métodos y dependencias
  • Llamadas y contratos HTTP
  • Productores y consumidores de Kafka
  • Algunos o todos los repositorios conectados
EN DESARROLLO

Análisis de código frontend

Detalles técnicos de la investigación

Mapeo de símbolos basado en SCIP

Relaciones de grafo

Recuperación léxica y semántica

Usa una solicitud real

Usa una solicitud real de tu equipo en la demo.

Mira cómo RefineBrief investiga el contexto técnico, expone decisiones pendientes y prepara los tickets de Jira antes del refinamiento.