Saltar a contenido

Control-Plane Privado · Gobernanza Bidireccional

Atlantyqa Universe

`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.

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

Ruta rápida por actor

Nuevo colaborador

Primero entra, luego aprende y valida el contexto mínimo.

Colaborador operativo

Coordina trabajo, deja evidencia y mide impacto.

Líder o decisor

Gobierna, protege confianza y valida decisiones con evidencia.

Operador de plataforma

Opera runtime, sincroniza entornos y observa tendencias.

Ver el mapa completo sin perder foco ### Dominios semánticos canónicos - [Entrar](portal/entrar/) - [Colaborar](portal/colaborar/) - [Gobernar](portal/gobernar/) - [Operar](portal/operar/) - [Aprender](portal/aprender/) - [Confiar](portal/confiar/) - [Medir](portal/medir/) - [Tendencias por rol/actor](portal/tendencias-rol-actor/)

Manifiesto Humano

atlantyqa-universe defiende una idea simple: los sistemas AI, móviles y automatizados que afectan a personas deben seguir siendo gobernables por humanos, con trazabilidad, control cognitivo y protección de salud mental.

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).

ATQ AI Operating System → ATQ multiplataforma → Abrir onboarding institucional → Completar quiz wizard → Ver control plane de la triada →

Objetivo del Repositorio

atlantyqa-universe coordina:

  1. detección y evaluación técnica de repositorios candidatos,
  2. adopción formal con migración a stack-tech-core/**,
  3. sincronización GitOps bidireccional con repos objetivo,
  4. control de entrada a main con protección de secretos e información privada industrial,
  5. documentación viva indexada de todos los proyectos adoptados,
  6. 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.

Mundo 02

Mundo Tech y ATQ

Arquitectura operativa, interfaz humana corta atq, gates de main, MicroK8s/Proxmox y runbooks internos.

Mundo 03

Mundo Negocio y Confianza

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

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.

Vista Arquitectura

Ontologia y Taxonomia Operativa

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

Vista Creativa

Storytelling de Plataforma

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

Primera Sesión Extendida (15 min)

  1. abrir GitHub Collaboration Hub y tomar una tarea del project board.
  2. abrir Protocolo de decisión humana y seleccionar modo operativa/regulado.
  3. ejecutar Quickstart para validar el flujo técnico mínimo.
  4. revisar Trust pack para alinear narrativa tech + negocio.
  5. 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.

Tambien es hacer visible que el uso de agentes en móvil y escritorio debe proteger a la persona: menos presión, más contexto, mejor criterio y decisiones humanas explícitas.

  • Ruta visual actual de la tríada operativa (Kabehz, L0KY, AJCG131281): portal/triad-control-plane/
  • 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

```bash

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 →