Skip to main content

🏛️ 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) mediante plugin.json y agent.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:

AgenteNombre en ClaveEspecialidad y Funciones
KratoskratosArquitecto de Documentación Técnica: Genera HLD, LLD, contratos de API, diagramas Mermaid y publica en el portal corporativo Docusaurus.
HérculesherculesIngeniero Senior Backend: Diseña, genera y refactoriza microservicios Java 21 LTS con Spring Boot 3.4.x, garantizando cobertura JaCoCo ≥ 80%.
ApoloapoloEspecialista Frontend MFE: Desarrolla Microfrontends Standalone en Angular 19+ con Signals, Tailwind, PrimeNG y reutilización de @alpura/commons.
HadeshadesAdministrador 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​

  1. Cero Secretos: Ningún archivo del repositorio contiene contraseñas, URLs privadas con tokens embebidos o certificados.
  2. 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 |
  3. Control de Versiones: La rama dev recibe el trabajo diario; los pases a producción y consolidación se realizan mediante Pull / Merge Requests revisados por Arquitectura.