Skip to main content

Platform Convention

Unified naming, organizational, and operational convention across Kubernetes, ArgoCD, Backstage, and Crossplane.

One semantic key drives every layer — no manual translation, no drift.

What is this?​

This document defines a comprehensive convention that ensures consistency across all layers of your platform infrastructure. From naming patterns to repository structure, Kubernetes labels to ArgoCD configurations, and Backstage entities to Crossplane resources — everything derives from a single, unified semantic key.

Key Principles​

  • Single semantic key drives every layer
  • No manual translation between systems
  • No drift between desired and actual state
  • Automation-first approach through templates
  • Convention over configuration