AI-Unified Requirements, Orchestration, Reasoning & Automation (AURORA)

Introducción

AURORA-IA es una metodología moderna diseñada para el desarrollo de software en la era de los agentes de inteligencia artificial. Su objetivo es unificar:

  • la intención expresada por humanos,

  • la especificación viva del sistema,

  • los comportamientos expresados en lenguaje natural estructurado (Gherkin),

  • la generación automatizada por agentes de IA,

  • la verificación contractual y técnica,

  • y la gobernanza mediante CI/CD.

El resultado es un marco claro, auditable, reproducible y altamente alineado con el desarrollo real de plataformas, APIs y sistemas empresariales complejos.

Propósito de la metodología

AURORA-IA busca resolver tres problemas críticos del desarrollo moderno:

  1. Falta de trazabilidad en entornos IA-asistidos — la IA genera rápido, pero no siempre coherente.

  2. Desalineación entre intención, comportamiento y código — lo que se dice ≠ lo que se hace.

  3. Ausencia de metodologías adaptadas a equipos humano+IA — procesos antiguos no sirven para agentes generativos.

AURORA-IA™ soluciona esto colocando la intención en el centro, formalizándola como especificación viva, y usando agentes IA con funciones claramente acotadas.

Principios (Manifiesto AURORA-IA)

  1. La intención precede al código.

  2. La especificación es la fuente de verdad.

  3. El comportamiento es un contrato verificable.

  4. La IA actúa con roles definidos, nunca improvisados.

  5. Todo cambio debe ser trazable, reversible y auditable.

  6. El pipeline CI/CD es el guardián final del sistema.

  7. La evolución es continua, iterativa e incremental.

Ciclo de Vida AURORA-IA (AURORA-Cycle)

AURORA-IA™ define un ciclo de 8 etapas:

1. Intención (Intent)
2. Especificación Viva (Spec)
3. Plan Técnico (Design)
4. Contratos de Comportamiento (Gherkin)
5. Generación Asistida (Agents)
6. Implementación Humana
7. Verificación y Gobernanza (CI/CD)
8. Evolución Continua

Diagrama del ciclo

Artefactos de AURORA-IA

Capa Artefacto Propósito
Intención intent.md Qué quiere negocio / arquitectura
Especificación Viva spec.md Reglas, casos de uso, contexto
Plan Técnico plan.md Arquitectura, decisiones, restricciones
Contratos *.feature Gherkin como contrato ejecutable
Implementación Código API, servicios, dominios
Verificación Tests Unitarios, contractuales
Gobernanza CI/CD Guardrails, protecciones
Decisiones ADRs Registro explícito de cambios

La metodología obliga a que todos los cambios comiencen en la intención y fluyan hacia abajo.

Roles AURORA-IA (Humano + IA)

Humanos

Arquitecto

  • Responsable de intención, coherencia y decisiones.

Developer

  • Implementa y refina código conforme al spec.

QA / Product Owner

  • Revisa escenarios Gherkin.

    Agentes IA

    Spec Agent

    • Mantiene spec.md, plan.md, tasks/*.md.

    Test Agent

    • Genera escenarios .feature.

    Code Agent

    • Propone implementación base y tests.

    Métricas de madurez AURORA-IA

    Métrica Objetivo
    % escenarios Gherkin verdes > 95%
    Drift Spec ↔ Code < 2%
    PRs bloqueadas por inconsistencias Indicador de salud
    % código generado por IA aceptado Métrica de eficiencia
    Tiempo ciclo intención → PR Debe bajar un 30–50%

    Mapa conceptual AURORA-IA​

    Ejemplo práctico: TaskBoard API bajo AURORA-IA

    Intención

    “Quiero un servicio que gestione tareas con un workflow simple (New → InProgress → Done) y permita consultas filtradas.”

    Especificación Viva (spec.md)

    Casos de uso:
- Crear tarea.
- Cambiar estado.
- Listar por estado.

Reglas:
- Título obligatorio.
- Estado inválido → 400.
- Tarea no encontrada → 404.

    Contratos de Comportamiento (TaskBoard.feature)

    Scenario: Crear tarea válida
  When creo una tarea "Diseño"
  Then la respuesta es 201
  And el estado es "New"

Scenario: Cambio a InProgress
  Given existe "API" con estado "New"
  When cambio su estado a "InProgress"
  Then la respuesta es 200

    Implementación mínima (C#)

    public class TaskItem {
    public int Id { get; set; }
    public string Title { get; set; } = default!;
    public string Status { get; set; } = "New";
}

    Contract Test Runner (sin SpecFlow o si quires puedes usar SpecFlow)

    public class GherkinRunner {
    public IEnumerable<(string Step, string Text)> Parse(string feature) { ... }
    public async Task ExecuteAsync(HttpClient client) { ... }
}

    Evaluación comparativa

    AURORA-IA supera a metodologías previas al integrar:

    Método IA nativa Intención Especificación Contratos Gobernanza Sistémico
    TDD No No No No Medio No
    BDD No Parcial No Si Medio Parcial
    DDD No Si No No Variable Si
    SbE No Si No Si Medio Parcial
    AURORA-IA TOTAL Si Si Si ALTO Si

     

    Aspectos evaluados:

    Columna Significado
    IA nativa Si la metodología está pensada para integrarse con IA o agentes generativos.
    Intención Si la metodología define explícitamente la intención/objetivo antes del diseño.
    Especificación Si existe artefacto formal como spec.md, documentación viva, etc.
    Contratos Si define comportamientos verificables (p. ej., Gherkin, ejemplos ejecutables).
    Gobernanza Si incluye prácticas de control, CI/CD, validación formal, políticas.
    Sistémico Si abarca todo el ciclo de vida (no solo diseño, o tests, o código).

    Guía de adopción organizacional

    Pasos:

    1. Introducir intención como artefacto obligatorio
    2. Incorporar .specify/ en todos los repos
    3. Configurar Spec/Test/Code Agents
    4. Introducir contract runner en CI
    5. Establecer métricas de drift
    6. Entrenar al equipo en el framework AURORA-IA.

    Conclusión

    AURORA-IA ofrece una forma moderna, trazable y gobernada de construir software en tiempos de IA generativa. Unifica intención, especificación viva, comportamiento contractual, agentes IA y verificación continua en un sistema coherente, práctico y escalable.

    Es una metodología lista para adopción en organizaciones que buscan velocidad sin sacrificar calidad, gobernanza o claridad.