Equipo y Roles

Metodología de Hackathon

Cuatro roles con responsabilidad definida trabajando concurrentemente sobre la rama principal (main), con commits automáticos, bitácoras por turno y tablero de estado continuo.

Distribución de Roles

Rol: Web & Frontend

Responsable de: apps/web y packages/catalogo.

Construcción de los 21 componentes de catálogo A2UI con shadcn/ui.
Implementación del sistema de diseño institucional Banorte.
Shell web móvil-primero con navegación por pestañas y modo oscuro.

Rol: MCP & Datos

Responsable de: apps/mcp y db/.

Servidor Streamable HTTP en Express con @modelcontextprotocol/sdk.
18 tools (14 de lectura analítica y 4 mutacionales).
Esquema PostgreSQL banorte con 22 tablas y datos sintéticos.

Rol: Contratos & Agente

Responsable de: packages/a2ui, packages/schemas y orquestador.

Desarrollo del motor propio A2UI v0.9.1 (~1,310 líneas, 112 pruebas).
Validación estricta con Ajv y contratos Zod.
Agente host con streaming JSONL y bridging hacia Gemini y Claude.

Rol: Demo & Documentación

Responsable de: Pitch, guión, checklist de calidad y arquitectura.

Cronometraje de los 3 minutos de demo y pitch de 5 minutos.
10 Decisiones de Arquitectura (ADRs) y análisis de trade-offs.
Documentación técnica integral para jurados y desarrolladores.

Reglas Innegociables de Desarrollo

Todo se documenta en dos niveles: Nivel “para cualquiera” (ejecutivo y funcional) y nivel “técnico” (archivos, contratos y schemas).
Determinismo numérico estricto: Ningún dato monetario o tasa de interés es inventado por el modelo; todo proviene de una tool MCP.
Persistencia real: Las acciones del usuario mutan PostgreSQL con clave de idempotencia única; ningún cambio vive solo en la memoria del front.
Main siempre verde: Todo commit pasa validación de tipos (pnpm typecheck) y pruebas unitarias (pnpm test).