Index

Private Control-Plane · Bidirectional Governance

`atlantyqa-universe` is the private monorepo used to govern the full lifecycle of adopted projects with bidirectional sync and strict secret controls.

Start operations Private area View governance contract

"We govern adopted repositories with evidence and policy controls, not ad-hoc decisions."

Day 1: Minimum Path (5 min)¶

Step 01

Pick one task¶

Open the board and select one active issue to avoid broad, noisy context switching. Open Project v2

Step 02

Run minimum validation¶

Execute the operational quickstart to validate governance, gate controls, and living docs. Go to Quickstart

Step 03

Leave human evidence¶

Close with a PR or comment that records explicit human approval and next action. Decision protocol

Institutional onboarding by corporate profile (collaborators, employees, partners, suppliers, and clients).

Open institutional onboarding → Complete quiz wizard →

Repository Objective¶

atlantyqa-universe coordinates:

discovery and technical assessment of candidate repositories,
formal adoption with migration to stack-tech-core/**,
bidirectional GitOps synchronization across target repos,
main entry control with secrets and private industrial data protection,
living indexed documentation for adopted projects,
accelerated collaborator enablement (junior and less technical profiles) through agent + governed PR workflows.

Guided Entry: GitHub + Tech + Business¶

World 01

GitHub Projects Operations¶

Daily issue/PR/project-v2 execution with explicit human approval traceability.

Open collaboration hub Project v2

World 02

Tech World and Runbooks¶

Operational architecture, main gates, MicroK8s/Proxmox and adopted-active runbooks.

Technical quickstart Compute map

World 03

Business and Trust World¶

Institutional stakeholder package: trust pack, one-pagers, and objection playbook.

Trust pack One-pagers

Overview: Technical, Architecture, Creative¶

Technical View

Runtime and Onion Segmentation¶

Real MicroK8s service inventory, runtime communication flows, and onion-layer risk segregation model.

Open runtime study Audience diagrams

Architecture View

Operational Ontology and Taxonomy¶

Semantic map to classify domains, contexts, and exposure roles across runtime components.

Semantic glossary Taxonomic forensics

Creative View

Platform Storytelling¶

Visual models that make complex architecture clear and actionable for onboarding and adoption.

Visual journey FPD architecture

Extended Session (15 min)¶

open the GitHub Collaboration Hub and pick one project-board task.
open Human Decision Protocol and choose daily or regulated mode.
run the Quickstart to validate the minimum technical flow.
review the Trust pack to align tech + business narrative.
close with a PR or explicit human-validation comment.

Agent-Based Talent Positioning¶

atlantyqa-universe does not aim to replace people. It increases team capability through evidence, security, and traceability.

Working path for junior technical profile (Angel) and less technical profile (Bosco): internal/private-collaborator-fast-learning.en.md
E2E Mermaid flows with inherited atlantyqa-universe libraries.
Real operating method with local Codex + Ubuntu + Git/GitHub + main gate control.

Governance Flow¶

Adopted Lifecycle¶

graph TD
    Inputs[inputs/repositories/**] --> Analyze[SCA and Risk Analysis]
    Analyze --> Decision[Adoption Decision]
    Decision --> Stack[stack-tech-core/**]
    Stack --> Sync[Bidirectional GitOps Sync]
    Sync --> Public[Public product repos]
    Sync --> Private[Private control repos]
    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

Operating Pillars¶

Adopted Portfolio Governance¶

Adopted projects are moved from `inputs/**` into `stack-tech-core/**` and treated as lifecycle-governed assets.

Main Gate + Secret Protection¶

`main-source-of-truth-gate` enforces controlled sync-only merges and blocks secret/private industrial content in public surfaces.

Living Documentation¶

ES/EN indexes and per-project sheets are generated automatically from GitOps catalogs and `stack-tech-core` governance records.

Quick Validation¶

# 1) Validate adopted-project governance
python3 scripts/verify/verify_stack_core_adoption.py

# 2) Validate adoption/bootstrap request
bash scripts/repo-bootstrap-from-inputs.sh \
  --mode validate \
  --request-file .github/repo-bootstrap/requests/atlantyqa-universe-public.yml

# 3) Validate living docs index
python3 scripts/generate-adopted-project-docs.py --check

Review the living adopted-project catalog and governance status.

View adopted projects →