🤖 Antigravity Scripts & Prompts
Repositorio Central de Gobernanza, Reglas Arquitectónicas y Skills de Inteligencia Artificial para el Ecosistema Alpura.
📌 1. Visión General
El proyecto Antigravity Scripts & Prompts actúa como el núcleo de estandarización arquitectónica y habilitador de IA asistida (Google Antigravity / Gemini CLI) para todos los squads de desarrollo y arquitectura de Alpura.
Su propósito fundamental es centralizar, versionar y distribuir de forma automatizada las directrices de arquitectura, estándares de codificación corporativos, patrones de diseño y lineamientos técnicos para el desarrollo Full-Stack (Backend Java / Spring Boot, Frontend Angular MFE, Calidad QA y Base de Datos Oracle).
A través de este ecosistema, cualquier ingeniero de software o agente de IA autónomo opera bajo el mismo conjunto unificado de reglas y mejores prácticas de la organización.
🎯 2. Objetivos Principales
- Gobernanza Unificada de IA: Proveer a los asistentes y agentes inteligentes (
Kratos,Hércules,Apolo,Hades) de un contexto técnico fidedigno y actualizado. - Distribución Automatizada: Sincronizar reglas corporativas hacia los entornos locales de los desarrolladores (
~/.gemini/) mediante scripts multiplataforma (bash,PowerShell,python). - Consistencia Arquitectónica: Garantizar que el código generado (Java Spring Boot, Angular Signals, Oracle SQL/PL-SQL) cumpla al 100% con los estándares y arquetipos de Alpura.
- Trazabilidad y Calidad: Imponer lineamientos estrictos de Bitácora de Cambios, cobertura de pruebas unitarias JaCoCo (mínimo 80%) y peer reviews de QA.
🏛️ 3. Dominios Técnicos Cubiertos
| Dominio | Tecnologías Clave | Responsabilidad Principal |
|---|---|---|
| Backend | Java 21 LTS, Spring Boot 3.4.x, Spring Cloud, Spring Batch | Arquetipos en capas, VO/DO, Dozer, validación centralizada, control de excepciones. |
| Frontend | Angular 19+, Module Federation, Signals, Tailwind / PrimeNG | Microfrontends (MFEs), consumo de catálogo @alpura/commons, MVVM reactivo. |
| Base de Datos | Oracle Database, PL/SQL | Gobernanza de modelos relacionales, contratos de APIs de Order Management. |
| QA y Calidad | Playwright, JUnit 5, JaCoCo, SonarQube | Planes de prueba, mitigación, certificados de calidad y peer reviews. |
| Agentes IA | Antigravity CLI, Gemini 3.8 / 1.5 Pro | Agentes especializados para arquitectura, backend, frontend y testing. |
🧭 4. Navegación de la Documentación
- HLD y Arquitectura: Diseño de alto nivel, flujo de sincronización y catálogo de agentes.
- Squad y Gobernanza: Integrantes, roles y responsabilidades de gobernanza técnica.
- Sincronización y Automatización: Guía de instalación, scripts shell y sincronizador Python.