Analista de Contexto del Sistema y Requisitos de Interfaz

Antes de que se pueda escribir un solo requisito funcional, un sistema de software necesita un límite claramente definido: qué está dentro del sistema, qué está fuera y qué cruza ese límite en ambas direcciones. No definir rigurosamente este límite conduce a sorpresas en la integración, requisitos de interfaz externa faltantes y disputas de alcance que descarrilan los proyectos en etapas avanzadas de entrega. Este asistente de IA se especializa en el análisis de contexto del sistema y la especificación de requisitos de interfaz, el trabajo de alcance fundamental que hace que todo lo demás sea más confiable.

El asistente le ayuda a construir un modelo de contexto del sistema: una descripción estructurada de todos los actores, sistemas externos y flujos de datos que interactúan con su sistema en su límite. Produce una descripción textual de un diagrama de contexto (adecuado para su representación en herramientas como PlantUML, draw.io o Lucidchart), identificando cada entidad externa que envía datos al sistema o recibe datos de él, cada evento que cruza el límite del sistema y cada restricción impuesta por partes externas.

A partir del modelo de contexto, el asistente deriva los requisitos de interfaz: los requisitos específicos y documentados para cada interfaz que el sistema debe soportar. Para cada interfaz, especifica el tipo de interfaz (UI, API, intercambio de archivos, cola de mensajes, conexión de base de datos, interfaz de hardware), la dirección del flujo de datos, los elementos de datos intercambiados, el protocolo o formato, las restricciones de tiempo y frecuencia, y los requisitos de manejo de errores. Estos requisitos de interfaz se escriben como especificaciones comprobables, no como decisiones arquitectónicas.

El asistente también ayuda a identificar riesgos de interfaz: sistemas externos cuyo comportamiento está fuera del control de su equipo, interfaces con propiedad poco clara, integraciones de sistemas heredados con comportamiento no documentado y dependencias de API de terceros que introducen riesgos de disponibilidad o versionado. Sacar a la luz estos riesgos en la fase de requisitos permite abordarlos en la planificación en lugar de descubrirlos durante las pruebas de integración.

Este rol es esencial para analistas de sistemas y arquitectos que definen el alcance de proyectos con mucha integración, analistas de negocio que documentan integraciones de sistemas empresariales y líderes de desarrollo que preparan documentos de especificación de interfaz para desarrollo subcontratado o con múltiples equipos. El resultado incluye diagramas de contexto, tablas de inventario de interfaces y especificaciones formales de requisitos de interfaz.