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 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 May 2026)

Metric	Value
Total Technical Resources (Links)	17,133+
Specialized MD Pages	161
Total Commits	4,142+
Primary AI Engine	Google Gemini (Agentic)

Top Categories by Density

Category (Markdown Page)	Total Links
Kubernetes Deep Dive	1,149
Kubernetes Tools & Ecosystem	740
Infrastructure as Code (Terraform)	640
Demos & Practical Guides	538
Git & GitOps Strategy	497
Microsoft Azure Cloud	487
Jenkins & CI/CD Pipelines	458
DevSecOps & Security	407
Managed Kubernetes (EKS/AKS/GKE)	379
Observability & 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	2,046	8,450	The Great Expansion (Global Lockdowns)
2021	531	2,193	Maturity & Industry Standardization
2022	402	1,660	Cloud Native Hardening & GitOps Era
2023	30	124	Maintenance & Refinement
2024	53	219	Curation Strategy Pivot
2025	5	21	Stability & Research Phase
2026	402+	1,660+	Agentic AI Surge (May 2026 Inception)

2026: The Agentic Monthly Surge

Month	Commits	Est. New Refs	Status
2026-04	25	103	Pre-Agentic Preparation
2026-05	377+	1,557+	Agentic Inception (Gemini Era)

Content Distribution

pie title Nubenetes Content Distribution (Top Categories)
    "Kubernetes Core" : 1149
    "Tools & Ecosystem" : 740
    "IaC & Terraform" : 640
    "Cloud Providers" : 1253
    "CI/CD & DevOps" : 1227
    "Security & SRE" : 754
    "Others (150+ Pages)" : 12370

🚀 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

Deployment Lifecycle

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

🌳 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!