devops-infra-argo-config-gcp/claude/00-overview.md

Per AI Blitz Plan §6. Layer: 1-T.

00 — Overview

devops-infra-argo-config is the infrastructure GitOps control plane for Meesho's Kubernetes fleet. It defines which infrastructure tools run on which clusters using ArgoCD's App-of-Applications pattern.

Role in the ecosystem

devops-infra-argo-config (this repo)        devops-infra-helm-charts
├── incubator/<env>/<cluster>.yaml ─────────► helm-templates/<chartDir>/
├── values/<env>/<cluster>-values.yaml ─────► helm-overrides/<cluster>/<valuesDir>/
├── generic-argo-apps-chart/                 │   └── custom-values.yaml
└── projects/                                └── ...

This repo tells ArgoCD what to deploy and where. The helm-charts repo provides how to deploy it (charts + override values).

Key characteristics

• Layer 1-T — Agent-Writable (Tool-Mediated). Changes are PRs reviewed by the platform team.
• App-of-Applications pattern — One parent Application per cluster renders all child tool Applications via a single generic Helm chart.
• ~19 clusters managed across prd, int, and admin environments.
• 20–50 infrastructure tools per cluster (monitoring, ingress, secrets, CI/CD, policy, etc.).
• Auto-sync — Merge to the env branch deploys immediately with no staging gate.

Branch → environment mapping

Branch	Environment	ArgoCD namespace	Values dir
main	Production (prd)	argocd-prd	values/prd/
develop	Staging (stg) + Dev (dev)	argocd-dev	values/dev/
pre-prod	Integration (int)	argocd-shared-int	values/int/