Nubenetes is a high-density, curated archive of the Kubernetes, Cloud Native, and Agentic AI ecosystem. Since its inception in 2018, it has evolved from a personal collection of references into an autonomous, AI-driven knowledge engine that processes thousands of technical resources to provide a definitive "Source of Truth" for engineers worldwide.

📖 Table of Contents

Introduction & Motivation
Repository Metrics & Evolution
The 2026 Architectural Shift
- From Manual to Agentic
- Evolution Path
Dual-Edition Architecture (V1 vs V2)
The Agentic Stack
The Agentic AI Engine
GitHub Workflows & Automation
- Workflow Inventory
- Curation Flow Architecture
Branching Strategy & Lifecycle
Developer Experience & VSCode Setup

🌟 Introduction & Motivation

Origins

Nubenetes was born in 2018 during a large-scale Cloud Native project for the BMW IT-Zentrum in Munich. The project involved building a self-service developer platform (BMW ConnectedDrive) with high standards of automation, GitOps patterns, and continuous improvement. The lessons learned from that German engineering environment—standardization, evidence-based decisions, and extreme automation—became the DNA of this repository.

Mission

In a market often driven by "Resume Driven Development" and calculated ambiguities, Nubenetes stands for Technical Correctness. We promote:

Evidence-based Engineering: Relying on standard tools and proven architectures (e.g., OpenShift, CloudBees/Jenkins).
Automation over Manual Work: If it can be scripted, it should be.
Knowledge Democratization: Breaking silos by sharing high-value, production-grade resources.

"If you want to save the world, think like an engineer." — Mark Stevenson

📊 Repository Metrics & Evolution

Nubenetes is one of the most comprehensive archives in the ecosystem, featuring tens of thousands of links organized by granular categories.

The "Heart" of Nubenetes (Stats as of 2026-05-15)

Metric	Value
Total Technical Resources (Links)	17133+
Specialized MD Pages	161
Total Commits	3967+
Primary AI Engine	Google Gemini (Agentic)

Top Categories by Density

Category (Markdown Page)	Total Links
Kubernetes	1149
Kubernetes Tools	740
Terraform	640
Demos	538
Git	497
Azure	487
Jenkins	458
Devsecops	407
Managed Kubernetes In Public Cloud	379
Monitoring	347

Historical Growth (Commits & References)

The growth of Nubenetes reflects the acceleration of the Cloud Native ecosystem. Since 2026, the adoption of Agentic AI has resulted in a vertical surge in both commit frequency and link discovery.

Annual Growth Summary

Year	Commits	Est. New Refs	Key Milestone
2018	350	1,445	Munich Era (BMW IT-Zentrum)
2019	142	586	Early Growth & Open Source Launch
2020	2046	8,449	The Great Expansion (Global Lockdowns)
2021	531	2,193	Maturity & Industry Standardization
2022	402	1,660	Cloud Native Hardening & GitOps Era
2023	30	123	Maintenance & Refinement
2024	53	218	Curation Strategy Pivot
2025	5	20	Stability & Research Phase
2026	408	1,685	Agentic AI Surge (May 2026 Inception)

2026: The Agentic Monthly Surge

Month	Commits	Est. New Refs	Status
2026-04	25	103	Active Curation
2026-05	383	1,581	Agentic Inception (Gemini Era)

Content Distribution & Semantic Clustering

Nubenetes uses AI-driven semantic clustering to organize its 17,000+ resources into logical pillars. Below is a detailed breakdown of how the archive is distributed.

1. Major Ecosystem Pillars

This chart shows the high-level distribution across the primary domains of Cloud Native engineering.

pie title Nubenetes Major Ecosystem Pillars
    "Kubernetes Ecosystem" : 3500
    "Developer Ecosystem" : 3000
    "Public/Private Cloud" : 2500
    "CI/CD & GitOps" : 2200
    "Others (Specialized)" : 2733
    "Infra as Code" : 1200
    "SRE & Observability" : 1000
    "Security & DevSecOps" : 1000

Kubernetes Ecosystem: Includes core K8s, tools, networking, security, and operators. This is the heart of the project, with over 3,500 curated references.
Developer Ecosystem: Covers programming languages (Go, Python, Java), VSCode, and web technologies. It reflects the "Dev" in DevOps.
Public/Private Cloud: Detailed resources for AWS, Azure, GCP, and specialized private cloud solutions like OpenShift and Rancher.

2. Deep Dive: Specialized Sub-ecosystems

To better understand the "Others" category, we break down the specialized technical domains that form the long-tail of Nubenetes.

pie title Deep Dive: Specialized Sub-ecosystems
    "Databases (SQL/NoSQL)" : 600
    "Demos & Boilerplates" : 538
    "AI & Agentic Systems" : 450
    "Web Servers & Runtimes" : 400
    "Message Queues & Data" : 336
    "Career & Recruitment" : 250
    "Linux & OS Hardening" : 265
    "Others (100+ Topics)" : 1161

AI & Agentic Systems: A rapidly growing category since May 2026, focusing on Gemini, MCP, and AI Agents. This is the new frontier of Cloud Native.
Databases: Deep coverage of relational (PostgreSQL/Crunchy) and NoSQL databases, including database version control with Liquibase.
Demos: High-value repositories with ready-to-use production boilerplates, perfect for "Day 0" projects.

🦾 The Agentic Stack

The autonomy of Nubenetes is powered by a modern, resilient tech stack that ensures 24/7 curation and maintenance.

Layer	Technology	Purpose
Orchestration	GitHub Actions	Scheduled & Event-driven execution (via `develop` branch).
Intelligence	Google Gemini 1.5 Pro	Resource evaluation, scoring, and classification.
Automation	Python 3.11	Core logic for parsing, gitops, and reporting.
Discovery	Twikit & Playwright	Autonomous scraping and account rotation.
Resilience	Identity Rotation	Evasion of anti-bot blocks using multiple profiles.
Deployment	MkDocs Material	High-performance static site generation for V1 and V2.

🚀 The 2026 Architectural Shift

From Manual to Agentic

Historically, Nubenetes was curated manually by extracting references from x.com/nubenetes (formerly Twitter). This was a labor-intensive process that relied on human memory and periodic batch updates.

As of May 2026, the repository has transitioned to a Fully Autonomous Agentic AI Architecture. Using Google's Gemini models, the system now scans multiple sources, evaluates technical relevance, and performs self-maintenance without human intervention.

Evolution Path

graph TD
    A["2018: Munich Era (BMW)"] --> B["2020: X.com Curation"]
    B --> C["2022: GitOps Workflow"]
    C --> D["2026: Agentic AI Surge"]
    D --> E["Gemini Discovery"]
    D --> F["Health Monitoring"]
    D --> G["V2 Elite Generation"]

🏛️ Dual-Edition Architecture (V1 vs V2)

Nubenetes now operates with two distinct editions to serve different engineering needs. Both are managed via GitOps and deployed to nubenetes.com.

V1: The Exhaustive Archive

Purpose: Preservation of all technical knowledge since 2018.
Scope: 17,000+ links across 160+ pages.
Source of Truth: The docs/ directory.
Deployment: nubenetes.com

V2: The Agentic Elite Edition

Purpose: A high-density, enterprise-grade portal for the 2026 ecosystem.
Algorithm: Uses the V2VisionEngine to select only the top 10% of resources based on quality, impact, and freshness.
Source of Truth: The v2-docs/ directory (Derived from V1).
Deployment: nubenetes.com/v2/

Comparison Matrix

Feature	V1 (Exhaustive)	V2 (Elite)
Philosophy	"Leave no resource behind"	"Only the best for 2026"
Volume	High (17k+ Links)	Optimized (~2k Links)
Depth	Historical & Wide	Cutting-edge & Deep
Filtering	Basic (Health only)	AI-Scored (🌟🌟🌟)
MVQ Check	No	Yes (Stale repos deprioritized)

🤖 The Agentic AI Engine

The heart of the new Nubenetes is a suite of AI Agents that operate on our develop branch:

AgenticCurator (src/agentic_curator.py):
- Discovery: Scans X.com (multiple accounts) and other curation sources.
- Evaluation: Uses Gemini to score resources based on technical significance, impact, and date.
- Classification: Automatically maps new resources to the correct .md page using semantic matching.
V2VisionEngine (src/v2_optimizer.py):
- Elite Selection: Scans the massive V1 archive to select the "Elite" top-tier resources.
- 2026 Taxonomy: Reorganizes the content into high-density dimensions (e.g., "Intelligent Control Plane").
- Deprioritization: Automatically identifies stale repositories (>4 years without activity) and reduces their visibility.
IntelligentHealthChecker (src/intelligent_health_checker.py):
- Resilience: Performs asynchronous health checks with 3x retry and identity rotation.
- Persistence: Instead of aggressive deletion, it flags [OFFLINE?] links to preserve historical technical context.

🛠️ GitHub Workflows & Automation

Nubenetes uses a complex network of GitHub Actions to maintain the archive.

Workflow Inventory

Workflow	File	Purpose	Trigger	Dependencies
Agentic Curation	`agentic_cron.yml`	Main engine: Discovery, Evaluation, and PR creation.	Monthly / Manual	None
V2 Elite Builder	`agentic_v2_builder.yml`	Generates the high-density Elite edition in `v2-docs/`.	After Curation	Agentic Curation
Link Health	`intelligent_link_cleaner.yml`	Global link health check & deduplication.	Monthly / Manual	None
Backup Curation	`agentic_backup.yml`	Processes historical backups (JSON/MD) into the repo.	Manual	None
README Sync	`readme_sync.yml`	Autonomous synchronization of metrics and diagrams.	Push to `develop`	None

Curation Flow Architecture

sequenceDiagram
    participant X as X.com / Sources
    participant G as Gemini Agent
    participant W as GitHub Workflow
    participant R as Repo (develop)
    participant S as README Sync

    W->>X: Extract Raw Data
    X-->>W: Raw JSON/MD
    W->>G: Evaluate & Score Assets
    G-->>W: Scored & Categorized Assets
    W->>W: Inject into docs/*.md
    W->>R: Create Pull Request
    Note over R: V2 Builder Triggered...
    W->>R: Update V2 Elite Edition
    R->>S: Trigger README Sync
    S->>R: Update Metrics & TOC

Deployment Lifecycle

graph LR
    A["AI Discovery"] --> B["V1 Update (develop)"]
    B --> C["CI/CD Build V1"]
    B --> D["V2 Vision Engine"]
    B --> Z["README Sync"]
    D --> E["V2 Update (develop)"]
    E --> F["CI/CD Build V2"]
    C --> G["nubenetes.com"]
    F --> H["nubenetes.com/v2/"]
    Z --> B

🌳 Branching Strategy & Lifecycle

Pre-2026 Era (Trunk-based): For years, Nubenetes followed a "git-trunk" model where all changes were made directly to the master branch.
Post-May 2026 (Modern Lifecycle):
- develop Branch: The primary branch for AI agents. All curation PRs and link updates target develop.
- master Branch: The production-ready branch. Used for stable releases and deployments.
- Automated Sync: Workflows are configured to always checkout develop to ensure the AI operates on the latest "bleeding edge" content.

💻 Developer Experience & VSCode Setup

To maintain the high-density structure of Nubenetes (including Tables of Contents and specific indentations for MkDocs Material), the following VSCode setup is recommended.

Extension Recommendations

Markdown All in One - Mandatory for automatic TOC generation and list management.
markdownlint - Ensures style consistency.
Mermaid Editor - To visualize the architecture diagrams.
GitHub Pull Requests - To review AI-generated curation PRs.

Recommended settings.json

{
    "markdown.extension.toc.levels": "2..6",
    "markdown.extension.tableFormatter.normalizeIndentation": true,
    "markdown.extension.toc.slugifyMode": "github",
    "markdown.extension.toc.orderedList": true,
    "markdown.extension.list.indentationSize": "adaptive",
    "files.autoSave": "afterDelay",
    "editor.detectIndentation": false,
    "editor.tabSize": 4,
    "window.zoomLevel": -1,
    "markdownlint.config": {
        "default": true,
        "MD013": false,
        "MD033": false,
        "MD007": { "indent": 4 },
        "no-hard-tabs": false
    },
    "editor.defaultFormatter": "vscode.github",
    "[markdown]": {
        "editor.defaultFormatter": "vscode.github"
    },
    "markdownlint.focusMode": false,
    "editor.renderWhitespace": "all",
    "editor.guides.bracketPairs": true,
    "files.exclude": {
        "**/.venv": true,
        "**/__pycache__": true
    }
}

Note: Material for MKDocs requires an indentation of 4 spaces for nested lists and TOCs to render correctly. This is strictly enforced via editor.tabSize: 4.

Give us a 🌟 on GitHub if you like this archive!