Home

Control-Plane Privado · Gobernanza Bidireccional

`atlantyqa-universe` es el mono repositorio privado para gobernar el ciclo de vida de proyectos adoptados, sincronizados en ambas direcciones y protegidos con controles de secretos.

Comenzar operación Área privada Ver contrato de gobernanza

"Gobernamos productos y repositorios adoptados con evidencia, no con improvisación."

Día 1: Ruta Mínima (5 min)¶

Paso 01

Toma una tarea¶

Abre el tablero y selecciona una issue en curso para no entrar en contexto difuso. Abrir Project v2

Paso 02

Ejecuta validación mínima¶

Corre el quickstart operativo para validar gobernanza, gate y documentación viva. Ir a Quickstart

Paso 03

Deja evidencia humana¶

Cierra con comentario o PR indicando decisión humana explícita y siguiente acción. Protocolo de decisión

Onboarding institucional por perfiles corporativos (colaboradores, empleados, socios, proveedores y clientes).

Abrir onboarding institucional → Completar quiz wizard →

Objetivo del Repositorio¶

atlantyqa-universe coordina:

detección y evaluación técnica de repositorios candidatos,
adopción formal con migración a stack-tech-core/**,
sincronización GitOps bidireccional con repos objetivo,
control de entrada a main con protección de secretos e información privada industrial,
documentación viva indexada de todos los proyectos adoptados,
capacitación acelerada de colaboradores (junior y no técnicos) con método agente + PR gobernada.

Entrada Guiada: GitHub + Tech + Negocio¶

Mundo 01

GitHub Projects Operativo¶

Gestión diaria de issues, PRs y proyecto v2 con trazabilidad de aprobación humana.

Abrir hub de colaboración Project v2

Mundo 02

Mundo Tech y Runbooks¶

Arquitectura operativa, gates de main, MicroK8s/Proxmox y runbooks de adopción adopted-active.

Quickstart técnico Mapa de cómputo

Mundo 03

Mundo Negocio y Confianza¶

Propuesta institucional para stakeholders: trust pack, one-pagers y argumentario de objeciones.

Trust pack One-pagers

Overview: Tecnicos, Arquitectos y Creativos¶

Vista Tecnica

Runtime y Segregacion Onion¶

Inventario real de servicios en MicroK8s, flujos entre componentes y propuesta de segregacion por capas de riesgo.

Abrir estudio runtime Ver diagramas por audiencia

Vista Arquitectura

Ontologia y Taxonomia Operativa¶

Mapa semantico para clasificar dominios, contextos y roles de exposicion de cada componente runtime.

Glosario semantico Forense taxonomico

Vista Creativa

Storytelling de Plataforma¶

Vistas visuales para explicar arquitectura compleja con narrativa clara y accionable para onboarding y adopcion.

Journey visual Arquitectura FPD

Primera Sesión Extendida (15 min)¶

abrir GitHub Collaboration Hub y tomar una tarea del project board.
abrir Protocolo de decisión humana y seleccionar modo operativa/regulado.
ejecutar Quickstart para validar el flujo técnico mínimo.
revisar Trust pack para alinear narrativa tech + negocio.
cerrar con PR o comentario de validación humana explícita.

Posicionamiento de Talento con Agentes¶

La ventaja de atlantyqa-universe no es reemplazar personas, sino aumentar su capacidad con evidencia, seguridad y trazabilidad.

Ruta de trabajo para perfil junior técnico (Ángel) y perfil menos técnico (Bosco): internal/private-collaborator-fast-learning.md
Flujos E2E con librerías heredadas de atlantyqa-universe en Mermaid.
Método operativo real con agente local Codex + Ubuntu + Git/GitHub + control de main.

Flujo de Gobierno¶

Ciclo de Vida Adoptado¶

graph TD
    Inputs[inputs/repositories/**] --> Analyze[Análisis SCA y Riesgo]
    Analyze --> Decision[Decisión de adopción]
    Decision --> Stack[stack-tech-core/**]
    Stack --> Sync[Sync bidireccional GitOps]
    Sync --> Public[Repos públicos por producto]
    Sync --> Private[Repos privados de control]
    Public --> Gate[Main Source-of-Truth Gate]
    Private --> Gate

    style Inputs fill:#f8f9fa,stroke:#cbd5e0,stroke-width:1px,color:#182232
    style Analyze fill:#fdf8ef,stroke:#e7ae4c,stroke-width:2px,color:#182232
    style Decision fill:#eef9f5,stroke:#37a880,stroke-width:2px,color:#182232
    style Stack fill:#eef9f5,stroke:#37a880,stroke-width:2px,color:#182232
    style Sync fill:#f8f9fa,stroke:#cbd5e0,stroke-width:1px,color:#182232
    style Public fill:#f8f9fa,stroke:#cbd5e0,stroke-width:1px,color:#182232
    style Private fill:#f8f9fa,stroke:#cbd5e0,stroke-width:1px,color:#182232
    style Gate fill:#fdf8ef,stroke:#e7ae4c,stroke-width:2px,color:#182232

Pilares Operativos¶

Portafolio Adoptado¶

Los proyectos adoptados pasan de `inputs/**` a `stack-tech-core/**` y se gobiernan como activos de ciclo de vida completo.

Main Gate + Secret Control¶

El contrato `main-source-of-truth-gate` restringe entrada a `main`, exige sincronización controlada y bloquea secretos o datos privados estratégicos.

Documentación Viva¶

Índice automático de proyectos adoptados (ES/EN) y fichas por proyecto, generado desde catálogos GitOps y `stack-tech-core`.

Validación Rápida¶

# 1) Validar gobernanza de proyectos adoptados
python3 scripts/verify/verify_stack_core_adoption.py

# 2) Validar request de bootstrap/adopción
bash scripts/repo-bootstrap-from-inputs.sh \
  --mode validate \
  --request-file .github/repo-bootstrap/requests/atlantyqa-universe-public.yml

# 3) Verificar documentación viva
python3 scripts/generate-adopted-project-docs.py --check

Consulta el catálogo vivo de proyectos adoptados y su gobernanza.

Ver proyectos adoptados →