From aa46ff2bd391a949a0e052859c764567804eee95 Mon Sep 17 00:00:00 2001
From: Graham McIntire <graham@mcintire.me>
Date: Wed, 29 Apr 2026 11:15:47 -0500
Subject: [PATCH] docs: replace flux/fluxcd references with argocd

---
 CLAUDE.md            | 13 +++++++------
 bin/deploy           |  2 +-
 docs/ARCHITECTURE.md |  3 +--
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index dc6e0d50..65d94b38 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -212,7 +212,7 @@ See `AGENTS.md` for the full set of coding constraints. Key reminders:
 
 ## Kubernetes Deployment
 
-**Prerequisites**: cert-manager, Traefik, MetalLB, FluxCD, GitLab Agent, NFS Provisioner
+**Prerequisites**: cert-manager, Traefik, MetalLB, ArgoCD (with `argocd-image-updater`), NFS Provisioner
 
 **Secrets** (1Password, `towerops` namespace):
 - `gitlab-registry` - Docker credentials
@@ -243,7 +243,7 @@ kubectl rollout restart deployment/towerops -n towerops
 
 **Important**: Losing CLOAK_KEY makes encrypted data unrecoverable.
 
-**Deployment**: FluxCD auto-applies `k8s/` manifests. Manual: `kubectl apply -k k8s/`
+**Deployment**: ArgoCD reconciles `k8s/` manifests automatically. Manual: `kubectl apply -k k8s/`
 
 ## Deployment
 
@@ -265,8 +265,9 @@ Towerops uses branch-based deployment with Forgejo CI/CD:
 - Only after tests pass:
   - Builds Docker image from `k8s/Dockerfile`
   - Pushes to container registry
-  - Updates `k8s/deployment.yaml` with new image tag
-  - FluxCD detects change and applies to cluster
+  - `argocd-image-updater` picks up the new tag (~2 min) and writes it to the
+    Application's `spec.source.kustomize.images`; ArgoCD then rolls the
+    Deployment. No commit to `k8s/deployment.yaml`.
 
 ### Deploying Changes
 
@@ -298,8 +299,8 @@ git push origin main:production
 # 2. Runs all e2e tests (must pass)
 # 3. Builds Docker image
 # 4. Pushes to container registry
-# 5. Updates k8s/deployment.yaml with new image tag
-# 6. FluxCD auto-applies changes (~5 minutes)
+# 5. argocd-image-updater picks up the new tag (~2 min)
+# 6. ArgoCD rolls the Deployment
 #
 # Watch progress: https://git.mcintire.me/graham/towerops-web/actions
 ```
diff --git a/bin/deploy b/bin/deploy
index 24c15fb8..144e33f5 100755
--- a/bin/deploy
+++ b/bin/deploy
@@ -60,7 +60,7 @@ git checkout main
 log "Deploy triggered."
 echo ""
 echo "  Staging:    pushed to main (Dokku auto-deploys)"
-echo "  Production: pushed to production (CI runs tests, builds image, FluxCD applies)"
+echo "  Production: pushed to production (CI runs tests, builds image, ArgoCD applies)"
 echo ""
 echo "  Monitor CI: https://git.mcintire.me/graham/towerops-web/actions"
 echo "  Monitor k8s: kubectl rollout status deployment/towerops -n towerops"
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 1fb0e8f9..86dea475 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -13,8 +13,7 @@ towerops/
 ├── c_src/                     # C NIFs (SNMP native interop)
 ├── docs/                      # Documentation
 ├── e2e/                       # End-to-end tests (Playwright)
-├── flux/                      # FluxCD / GitOps manifests
-├── k8s/                       # Kubernetes manifests
+├── k8s/                       # Kubernetes manifests (reconciled by ArgoCD)
 ├── lib/
 │   ├── mix/                   # Custom Mix tasks
 │   ├── snmpkit/               # SNMP toolkit (native extension)