# ArgoCD Cluster Bootstrapping - Project Structure > Complete directory tree and file organization for the multi-repository GitOps environment. - Skill: `tools-only/argocd-cluster-bootstrapping-project-structure` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add tools-only/argocd-cluster-bootstrapping-project-structure` - Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/argocd-cluster-bootstrapping-project-structure/raw - Safety review: pending (external: skill-scanner PASS, skillspector CAUTION) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tools-only (https://skillmd.com/u/tools-only) - Updated: 2026-09-29 - Page: https://skillmd.com/skills/tools-only/argocd-cluster-bootstrapping-project-structure --- # ArgoCD Cluster Bootstrapping - Project Structure Complete directory tree and file organization for the multi-repository GitOps environment. --- ## Skill Structure ``` .claude/skills/argocd-cluster-bootstrapping/ ├── SKILL.md # Main entry point └── references/ ├── summary.md # Overview and scope ├── workflow.md # Step-by-step bootstrap process ├── tools.md # CLI commands and scripts ├── guidance.md # Best practices and troubleshooting ├── architecture.md # System architecture deep dive ├── project-structure.md # This file └── templates/ ├── README.md # Template usage guide ├── cluster-secret.yaml # Cluster registration secret ├── argocd-project.yaml # RBAC project definition ├── applicationset-cluster-generator.yaml ├── applicationset-matrix-generator.yaml ├── values-base.yaml # Base Helm values ├── values-dev.yaml # Development values ├── values-prd.yaml # Production values ├── external-secret-store.yaml # External Secrets config └── bootstrap-script.sh # Automation script ``` --- ## Infrastructure Repository Structure ``` infra-team/ │ ├── applicationset/ # ApplicationSet definitions │ │ │ ├── kube-addons/ # Platform components │ │ ├── cert-manager.yaml # 📄 Certificate management │ │ ├── external-secrets.yaml # 📄 Secret management │ │ ├── external-dns.yaml # 📄 DNS automation │ │ ├── ingress-nginx.yaml # 📄 Ingress controller │ │ ├── prometheus-stack.yaml # 📄 Monitoring │ │ ├── loki.yaml # 📄 Logging │ │ ├── grafana.yaml # 📄 Visualization │ │ ├── argocd-image-updater.yaml # 📄 Image automation │ │ └── kargo.yaml # 📄 Progressive delivery │ │ │ ├── applications/ # Business applications │ │ ├── cafehyna/ │ │ │ ├── api.yaml │ │ │ ├── web.yaml │ │ │ └── workers.yaml │ │ ├── loyalty/ │ │ │ └── loyalty-api.yaml │ │ └── painelclientes/ │ │ └── panel-web.yaml │ │ │ └── master-applicationset.yaml # 📄 Orchestrator │ ├── argocd-clusters/ # Cluster registration │ │ │ │ # Development clusters │ ├── cafehyna-dev.yaml # 📄 labels: env=dev, node-type=spot │ ├── loyalty-dev.yaml # 📄 labels: env=dev, node-type=spot │ ├── sonora-dev.yaml # 📄 labels: env=dev, node-type=spot │ │ │ │ # Homologation clusters │ ├── cafehyna-hlg.yaml # 📄 labels: env=hlg, node-type=mixed │ ├── loyalty-hlg.yaml # 📄 labels: env=hlg, node-type=mixed │ │ │ │ # Production clusters │ ├── cafehyna-prd.yaml # 📄 labels: env=prd, node-type=standard │ ├── loyalty-prd.yaml # 📄 labels: env=prd, node-type=standard │ │ │ │ # Hub cluster │ └── cafehyna-hub.yaml # 📄 labels: env=hub, tier=platform │ ├── argocd-projects/ # RBAC definitions │ │ │ │ # Platform projects │ ├── platform.yaml # 📄 Platform team project │ │ │ │ # Cluster-specific projects │ ├── cafehyna-dev.yaml # 📄 Dev cluster project │ ├── cafehyna-hlg.yaml # 📄 HLG cluster project │ ├── cafehyna-prd.yaml # 📄 PRD cluster project │ ├── loyalty-dev.yaml │ ├── loyalty-hlg.yaml │ └── loyalty-prd.yaml │ ├── argocd/ # ArgoCD configuration │ ├── argocd-cm.yaml # 📄 ConfigMap │ ├── argocd-rbac-cm.yaml # 📄 RBAC ConfigMap │ ├── argocd-secret.yaml # 📄 Secrets │ ├── argocd-notifications-cm.yaml # 📄 Notifications config │ └── argocd-notifications-secret.yaml # 📄 Notifications secrets │ ├── applicationset-templates/ # Reusable templates │ ├── multi-source-helm.yaml # 📄 Standard multi-source pattern │ ├── cluster-generator.yaml # 📄 Cluster generator base │ ├── matrix-generator.yaml # 📄 Matrix generator base │ └── progressive-rollout.yaml # 📄 Progressive delivery │ ├── helm-charts/ # Custom Helm charts │ ├── common/ # Shared templates │ │ └── templates/ │ │ ├── _helpers.tpl │ │ ├── deployment.yaml │ │ ├── service.yaml │ │ └── ingress.yaml │ └── applications/ # Business app charts │ ├── cafehyna-api/ │ │ ├── Chart.yaml │ │ ├── values.yaml │ │ └── templates/ │ └── loyalty-api/ │ └── scripts/ # Operational scripts ├── bootstrap-cluster.sh # 📄 Cluster bootstrap ├── validate-cluster.sh # 📄 Cluster validation ├── cleanup-cluster.sh # 📄 Cluster removal ├── sync-all-apps.sh # 📄 Bulk sync └── check-health.sh # 📄 Health check ``` --- ## Values Repository Structure ``` argo-cd-helm-values/ │ └── kube-addons/ │ ├── cert-manager/ # Certificate management │ ├── base/ │ │ └── values.yaml # 📄 Base values (all envs) │ ├── cafehyna-dev/ │ │ └── values.yaml # 📄 Dev: spot tolerations │ ├── cafehyna-hlg/ │ │ └── values.yaml # 📄 HLG: 2 replicas │ ├── cafehyna-prd/ │ │ └── values.yaml # 📄 PRD: 3 replicas, HA │ ├── loyalty-dev/ │ │ └── values.yaml │ ├── loyalty-hlg/ │ │ └── values.yaml │ └── loyalty-prd/ │ └── values.yaml │ ├── external-secrets/ # Secret management │ ├── base/ │ │ └── values.yaml │ ├── cafehyna-dev/ │ │ └── values.yaml │ ├── cafehyna-hlg/ │ │ └── values.yaml │ └── cafehyna-prd/ │ └── values.yaml │ ├── ingress-nginx/ # Ingress controller │ ├── base/ │ │ └── values.yaml # 📄 Metrics, service config │ ├── cafehyna-dev/ │ │ └── values.yaml # 📄 Spot tolerations, 1 replica │ ├── cafehyna-hlg/ │ │ └── values.yaml # 📄 Mixed nodes, 2 replicas │ └── cafehyna-prd/ │ └── values.yaml # 📄 Standard nodes, 3 replicas, PDB │ ├── prometheus-stack/ # Monitoring │ ├── base/ │ │ └── values.yaml # 📄 ServiceMonitors, rules │ ├── cafehyna-dev/ │ │ └── values.yaml # 📄 3d retention, 10Gi storage │ ├── cafehyna-hlg/ │ │ └── values.yaml # 📄 7d retention, 50Gi storage │ └── cafehyna-prd/ │ └── values.yaml # 📄 30d retention, 200Gi storage │ ├── loki/ # Logging │ ├── base/ │ │ └── values.yaml │ ├── cafehyna-dev/ │ │ └── values.yaml │ ├── cafehyna-hlg/ │ │ └── values.yaml │ └── cafehyna-prd/ │ └── values.yaml │ ├── external-dns/ # DNS automation │ ├── base/ │ │ └── values.yaml │ ├── cafehyna-dev/ │ │ └── values.yaml │ └── cafehyna-prd/ │ └── values.yaml │ ├── grafana/ # Visualization │ ├── base/ │ │ └── values.yaml │ └── cafehyna-hub/ │ └── values.yaml │ └── ... (28+ components) ``` --- ## Documentation Repository Structure ``` docs/ │ ├── argocd/ # ArgoCD documentation │ ├── argocd-architecture.md # 📄 System architecture │ ├── argocd-applicationsets.md # 📄 ApplicationSet guide │ ├── argocd-multi-source.md # 📄 Multi-source patterns │ ├── argocd-rbac.md # 📄 RBAC configuration │ ├── argocd-notifications.md # 📄 Notification setup │ └── argocd-troubleshooting.md # 📄 Common issues │ ├── clusters/ # Cluster documentation │ ├── cafehyna-dev.md # 📄 Dev cluster profile │ ├── cafehyna-hlg.md # 📄 HLG cluster profile │ ├── cafehyna-prd.md # 📄 PRD cluster profile │ ├── cafehyna-hub.md # 📄 Hub cluster profile │ └── cluster-inventory.md # 📄 Full inventory │ ├── components/ # Component documentation │ ├── cert-manager.md # 📄 Certificate setup │ ├── external-secrets.md # 📄 Secret management │ ├── ingress-nginx.md # 📄 Ingress configuration │ ├── prometheus-stack.md # 📄 Monitoring setup │ └── loki.md # 📄 Logging setup │ ├── runbooks/ # Operational runbooks │ ├── cluster-bootstrap.md # 📄 Bootstrap procedure │ ├── cluster-upgrade.md # 📄 Upgrade procedure │ ├── disaster-recovery.md # 📄 DR procedures │ └── incident-response.md # 📄 Incident handling │ └── getting-started.md # 📄 Quick start guide ``` --- ## File Counts Summary | Category | Count | Description | |----------|-------|-------------| | ApplicationSets | 40+ | Dynamic application deployment | | Cluster Secrets | 9 | Registered clusters | | ArgoCD Projects | 10+ | RBAC boundaries | | Values Files | 200+ | Component × cluster configurations | | Documentation | 50+ | Guides and runbooks | | Scripts | 100+ | Operational automation | --- ## Naming Conventions ### Files ``` Pattern: -.yaml Examples: applicationset/kube-addons/ingress-nginx.yaml argocd-clusters/cafehyna-dev.yaml argocd-projects/platform.yaml ``` ### Directories ``` Pattern: /// Examples: kube-addons/ingress-nginx/cafehyna-dev/ applications/cafehyna/api/ ``` ### Values Files ``` Pattern: kube-addons///values.yaml Examples: kube-addons/ingress-nginx/base/values.yaml kube-addons/ingress-nginx/cafehyna-dev/values.yaml kube-addons/prometheus-stack/cafehyna-prd/values.yaml ```