🏛️ High-Level Design (HLD) - Antigravity Scripts & Prompts
Versión: 1.0 | Fecha: 2026-10-20 | Autor: Arquitectura Alpura / Squad Antigravity | Estado: Aprobado
1. Resumen Ejecutivo
El sistema Antigravity Scripts & Prompts constituye la infraestructura centralizada de configuración, directrices de ingeniería y agentes autónomos de IA para el equipo de desarrollo de Alpura.
Permite que las herramientas basadas en LLMs (Gemini CLI / Antigravity) adquieran de forma inmediata y estandarizada todo el contexto del negocio, patrones de diseño obligatorios, convenciones de nombres, estructura de carpetas y restricciones de calidad definidas por el área de Arquitectura Empresarial.
2. Alcance del Sistema
✅ Lo que SÍ cubre
- Centralización de reglas maestras en
GEMINI.md. - Definición de lineamientos especializados para Backend (Java 21 / Spring Boot 3.4), Frontend (Angular 19 MFE) y Base de Datos Oracle.
- Definición de prompts de Aseguramiento de Calidad (QA), planes de prueba y checklists de peer review.
- Catálogo de agentes autónomos de IA (
kratos,hercules,apolo,hades) medianteplugin.jsonyagent.md. - Scripts automatizados multiplataforma (
update-and-run.sh,sync_skills.py,antigravity-confi-windows.ps1) para distribuir skills hacia~/.gemini/skills/. - Trazabilidad obligatoria mediante Bitácora de Cambios en
README.md.
❌ Fuera de alcance
- No almacena credenciales ni tokens sensibles en el repositorio.
- No ejecuta directamente los despliegues de infraestructura en GCP (delegado a Terraform / Cloud Build).
3. Arquitectura Lógica de la Solución
4. Catálogo de Agentes Autónomos (Plugins de IA)
El proyecto define perfiles especializados para distintas fases del ciclo de vida del desarrollo:
| Agente | Nombre en Clave | Especialidad y Funciones |
|---|---|---|
| Kratos | kratos | Arquitecto de Documentación Técnica: Genera HLD, LLD, contratos de API, diagramas Mermaid y publica en el portal corporativo Docusaurus. |
| Hércules | hercules | Ingeniero Senior Backend: Diseña, genera y refactoriza microservicios Java 21 LTS con Spring Boot 3.4.x, garantizando cobertura JaCoCo ≥ 80%. |
| Apolo | apolo | Especialista Frontend MFE: Desarrolla Microfrontends Standalone en Angular 19+ con Signals, Tailwind, PrimeNG y reutilización de @alpura/commons. |
| Hades | hades | Administrador y Modelador Oracle: Diseña esquemas, tablas, índices, consultas SQL eficientes y contratos PL/SQL de Order Management. |
5. Diagrama de Secuencia: Sincronización de Reglas a la Estación de Trabajo
6. Matriz de Seguridad y Reglas de Trazabilidad
- Cero Secretos: Ningún archivo del repositorio contiene contraseñas, URLs privadas con tokens embebidos o certificados.
- Bitácora Obligatoria: Todo cambio realizado por desarrolladores o agentes de IA debe registrarse en la tabla de bitácora del
README.md:- Formato:
| Fecha y Hora | Usuario | Descripción de la Modificación | Archivos Afectados |
- Formato:
- Control de Versiones: La rama
devrecibe el trabajo diario; los pases a producción y consolidación se realizan mediante Pull / Merge Requests revisados por Arquitectura.