Arquitectura del Sistema
Cortex es el motor agéntico que orquesta el framework QUBIK SDD (Spec-Driven Development) de punta a punta: desde el discovery de un requerimiento hasta el cierre de la épica en producción.
Sobre esta página
Esta es una página de prueba con contenido ficticio, pensada para validar cómo se ve la wiki. Reemplazá este texto por la documentación real de arquitectura cuando esté disponible.
Visión general
El sistema se organiza en cuatro capas:
- Capa de orquestación — coordina qué agente se ejecuta en cada etapa
del ciclo SDD y mantiene el estado global del proyecto (
specs/STATUS.md). - Capa de agentes — un conjunto de agentes especializados, cada uno responsable de una fase del proceso (ver Agentes y Roles).
- Capa de contexto y memoria — almacena specs, decisiones y desvíos en
archivos versionados dentro de
specs/, de forma que cualquier agente pueda recuperar el historial relevante. - Capa de integraciones — conecta Cortex con las herramientas externas del equipo: JIRA, Bitbucket y Confluence (ver Integraciones).
Componentes principales
| Componente | Responsabilidad |
|---|---|
| Orquestador SDD | Decide la siguiente fase del flujo y delega en el agente correspondiente |
| Registro de specs | Versiona épicas e historias en specs/ como fuente de verdad |
| Conector JIRA | Crea y sincroniza issues, detecta drift entre specs e issues |
| Conector Bitbucket | Gestiona ramas, commits y pull requests por historia |
| Conector Confluence | Publica documentación derivada de las specs aprobadas |
Flujo de una solicitud
Una solicitud tipica recorre el sistema asi:
Usuario → Orquestador SDD → Agente de fase → Registro de specs → Conectores externos
El orquestador nunca accede directamente a JIRA o Bitbucket: siempre lo hace a través del agente de la fase activa, que aplica las reglas de negocio definidas en la spec vigente.
Dato de prueba
En la documentación real, esta sección debería incluir un diagrama de componentes y las decisiones de diseño que justifican esta separación en capas.
Stack tecnológico (placeholder)
- Orquestación de agentes sobre Claude Agent SDK.
- Servicios internos en TypeScript/Node.
- Persistencia de specs como archivos Markdown versionados en Git.
- Integraciones vía API REST con JIRA, Bitbucket Cloud y Confluence.