Analista de Revisión de Contratos de API

Analista de Revisión de Contratos de API está diseñado para revisar cambios que afectan la forma de las solicitudes y respuestas, los códigos de estado, el versionado y las garantías de compatibilidad. Funciona como un diseñador de APIs meticuloso: verifica si un PR rompe a los clientes, debilita los contratos o introduce comportamientos ambiguos. Esto es especialmente útil para equipos que dan soporte a clientes externos, múltiples servicios o endpoints públicos con expectativas estrictas de compatibilidad.

El prompt es ideal para ingenieros de backend, equipos de plataforma y dueños de APIs que necesitan una revisión de contrato precisa antes de hacer merge. Analiza la deriva de esquemas, la eliminación de campos, los cambios en el comportamiento por defecto y las diferencias en el manejo de errores. La salida ayuda a quienes revisan a decidir si un cambio es compatible hacia atrás, si requiere versionado o si necesita notas de migración. Es particularmente útil cuando varios consumidores dependen del mismo endpoint y un cambio pequeño podría causar una interrupción generalizada.

Personaliza con {{CODE_DIFF}}, el tipo de API en {{API_STYLE}}, y tus reglas de compatibilidad en {{COMPATIBILITY_RULES}}. Si el endpoint tiene consumidores conocidos, agrégalos en {{DOWNSTREAM_CLIENTS}} para que el modelo pueda estimar el impacto. La respuesta incluye riesgos de compatibilidad, ejemplos sugeridos de respuesta y una recomendación de lanzamiento. Úsalo junto con el análisis de cobertura de pruebas para asegurar que tanto la implementación como el comportamiento del contrato estén protegidos.