diff --git a/README.md b/README.md
index f981e89..aeec080 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,40 @@
 # k8s-manifests
 
-Kubernetes manifests for chemavx cluster - GitOps with ArgoCD
\ No newline at end of file
+GitOps repository for chemavx k3s cluster managed by ArgoCD.
+
+## Structure
+
+```
+├── argocd/          # ArgoCD deployment
+├── authentik/       # Authentik SSO
+├── backup-system/   # Backup jobs
+├── cert-manager/    # TLS certificate management
+├── cloudflare-ddns/ # Cloudflare DDNS
+├── gitea/           # Gitea Git server
+├── homarr/          # Dashboard
+├── monitoring/      # Prometheus + Grafana stack
+├── n8n/             # n8n workflow automation
+├── openclaw/        # OpenClaw service
+└── vaultwarden/     # Bitwarden-compatible vault
+```
+
+## Cluster Info
+
+- **Node**: chemavx (k3s v1.34.3)
+- **Ingress**: Traefik
+- **TLS**: cert-manager + Let's Encrypt (letsencrypt-prod)
+- **Storage**: local-path provisioner
+- **GitOps**: ArgoCD @ argocd.chemavx.xyz monitoring this repo
+
+## Services
+
+| Service | URL |
+|---------|-----|
+| Gitea | https://git.chemavx.xyz |
+| ArgoCD | https://argocd.chemavx.xyz |
+| n8n | https://n8n.chemavx.xyz |
+| Grafana | https://grafana.chemavx.xyz |
+| Authentik | https://auth.chemavx.xyz |
+| Vaultwarden | https://vaultwarden.chemavx.xyz |
+| Homarr | https://home.chemavx.xyz |
+| Uptime Kuma | https://uptime.chemavx.xyz |