AI CodeOps

Agente Backend Engineer

El agente Backend Engineer implementa el lado del servidor de una funcionalidad a partir de un diseño aprobado, con los archivos tocados y el impacto en la API. Se ejecuta en Feature SDLC.

El agente Backend Engineer implementa cambios del lado del servidor. Trabaja a partir de un diseño aprobado y describe el cambio: los archivos que toca, el código clave y el impacto en las API.

Dónde se ejecuta

Flujo de trabajoPaso
Feature SDLCBackend

Feature SDLC es el flujo de trabajo integrado más largo, con ocho pasos: requisitos, plan de entrega, diseño técnico, backend, frontend, pruebas de extremo a extremo, revisión de seguridad y documentación de usuario. El Backend Engineer es el paso cuatro. Va justo después del diseño técnico del Architect y antes del Frontend Engineer.

Entradas

  • La tarea de la sesión.
  • Una instantánea de solo lectura de los archivos relevantes del repositorio del proyecto: rutas, servicios, modelos de datos y pruebas existentes.
  • Los pasos anteriores: los requisitos del Product Analyst, el plan de entrega y el diseño técnico. En un flujo de trabajo de ocho pasos, le llegan abreviados.

Salidas

Una descripción del cambio del lado del servidor, archivo por archivo, con:

  • Los endpoints nuevos y modificados, y si algún cambio rompe a quienes ya los llaman.
  • Los cambios en el modelo de datos, que el diseño ya debería haber nombrado.
  • El manejo de errores y la validación.

El Frontend Engineer desarrolla contra la API que describe. Después del paso Frontend, la pasada de código de la sesión escribe los archivos en una copia desechable del repositorio y las pruebas del proyecto se ejecutan contra ese diff. Los tres últimos pasos (E2E tests, Security review y User docs) se ejecutan entonces sobre el cambio escrito, y la pasada de hallazgos revisa el diff.

Ejemplo de ejecución

Ejemplo ilustrativo, no una sesión registrada. Para una funcionalidad que permite a los clientes guardar filtros predefinidos, el Backend Engineer propone una tabla de filtros predefinidos que pertenecen al usuario y al espacio de trabajo, tres endpoints para listarlos, crearlos y eliminarlos, y un límite de 20 filtros predefinidos por usuario con un error claro al superarlo. Señala que el listado debe limitarse al espacio de trabajo de quien llama y que eliminar el filtro de otra persona debe devolver not-found en lugar de forbidden. Después, el Frontend Engineer planifica la interfaz contra esos endpoints.

Límites

  • No ejecuta un servidor, una base de datos ni migraciones. Describe código.
  • La pasada de código lee una cantidad fija de lo que escribieron los pasos anteriores. En Feature SDLC son cinco pasos largos, así que partes de los últimos pueden quedar fuera de lo que lee. Comprueba que el diff cubre lo planificado.
  • Los cambios incompatibles en la API se notifican en texto. Nada impone el versionado salvo que lo hagan tus pruebas. Consulta controles de calidad.

Preguntas frecuentes

¿Por qué no usar el agente Builder para esto?

Feature SDLC divide la implementación en dos para que el trabajo del servidor y el del cliente tengan cada uno un paso propio. El Backend Engineer se ocupa del lado del servidor y el Frontend Engineer, del lado del cliente.

¿Escribe los archivos él mismo?

No. Como todos los agentes, devuelve texto. La pasada de código de la sesión escribe los archivos y produce el diff después del paso Frontend, antes de los pasos que comprueban el trabajo.