Auditoría de Specs con Quality Guard - Axiooma

Auditoría de Specs con Quality Guard

El Quality Guard es una funcionalidad fundamental de la plataforma Axiooma. Opera como un auditor de requisitos automatizado que analiza tus especificaciones (Specs) y las puntúa en una escala del 1.0 al 10.0, señalando vacíos lógicos, ambigüedades y casos de borde no resueltos antes de que empiece a escribirse código.

Dimensiones de Evaluación

Quality Guard analiza tus especificaciones a través de tres dimensiones críticas de ingeniería de requisitos:

1. Completitud de la Información

• Objetivo: Asegurar que el Spec explique el qué, el por qué y el para quién de la funcionalidad propuesta.
• Criterios: Presencia de objetivos de negocio medibles, reglas de validación de datos, flujos de error explícitos y límites del sistema definidos.

2. Detección de Ambigüedades e Inconsistencias

• Objetivo: Evitar que los desarrolladores malinterpreten las reglas debido a un lenguaje vago o a afirmaciones contradictorias.
• Criterios: Uso de verbos imperativos claros, eliminación de términos subjetivos (ej. “rápido”, “a veces”, “según sea necesario”) y coherencia lógica entre las distintas secciones.

3. Separación de la Solución (Aislamiento Técnico)

• Objetivo: Garantizar que el Spec describa el comportamiento del negocio y sus restricciones, sin imponer decisiones de interfaz de usuario detalladas (ej. colores, botones específicos) o detalles estrictos de base de datos o APIs.
• Criterios: El diseño y las decisiones técnicas finales deben dejarse a los diseñadores y programadores; el documento de requisitos debe centrarse en el comportamiento lógico.

Veredictos de Calidad

Al finalizar la auditoría, se asigna uno de los siguientes veredictos según el score obtenido:

• APTO PARA DISEÑO (Score ≥ 9.0): La especificación es sólida, está completa y libre de ambigüedades. Está madura para pasar a manos de diseñadores y desarrolladores.
• REVISIÓN REQUERIDA (Score 5.0 - 8.99): El documento tiene una buena base pero carece de detalles clave (ej. flujos de error o casos límite). El agente de IA compilará una lista de tareas (Todo) para ayudarte a solucionarlo.
• RECHAZADO (Score < 5.0): La especificación es altamente incompleta, mezcla reglas de negocio con decisiones prematuras de implementación o posee errores lógicos graves. Requiere una reescritura profunda.

Cómo Mejorar el Score de Calidad

1. Revisa los puntos de mejora y fallos detectados por el Quality Guard.
2. Abre el Chat del Agente en el panel derecho del editor.
3. Pídele ayuda específica al agente, por ejemplo: “Ayúdame a redactar las reglas de validación de datos que señala Quality Guard que me faltan”.
4. Aplica las sugerencias e introduce los cambios en el editor. Vuelve a ejecutar la auditoría hasta alcanzar el veredicto óptimo.