Argo CD GitOps AI Skill Guide (Claude)

Overview & Engine Architecture

Argo CD continuously reconciles cluster state to Git-defined desired state (plain YAML, Helm, Kustomize, Jsonnet). An Application binds repo path + revision to a cluster/namespace; AppProject enforces allowlists. The controller diff-computes live vs desired, sync applies patches, and health assesses resource readiness. Agents treat Git as source of truth—no kubectl edit on managed objects—and respect prune/selfHeal blast radius.

┌─────────────────────────────────────────────────────────────┐
│                 Argo CD reconciliation                      │
│                                                             │
│  Git repo (main) → Application controller                   │
│       ↓ compare + hydrate (helm/kustomize)                  │
│  Cluster API ← sync (hooks, waves, replace options)         │
│  UI/CLI: Synced/OutOfSync, Healthy/Degraded/Progressing   │
└─────────────────────────────────────────────────────────────┘