> Per [AI Blitz Plan §6](../docs/global/AGENT_BOUNDARIES.md). 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

```text
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/` |