oleg-lukasonokandClaude Opus 5
fd003960c0
Aligns the skill name with the renamed repository and the development-* naming used by development-scripts. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
51 lines
2.2 KiB
Markdown
51 lines
2.2 KiB
Markdown
# development-gitops-argo-cd
|
|
|
|
Agent Skill for GitOps repositories where **ArgoCD** syncs cluster state from a
|
|
**Copier**-templated Git repo — app-of-apps `Application` manifests under `cluster/argocd/`,
|
|
Helm `values.yaml.jinja` templates under `cluster/resources/`, Jinja2 conditional directory
|
|
names used as feature flags, and per-environment `copier-answers.yaml` files.
|
|
|
|
The rules are repo-agnostic; `references/cogarchhubgitops-reference.md` records
|
|
CogArchHubGitOps as the concrete reference implementation (bands in use, flag names, global
|
|
settings, ordering dependencies).
|
|
|
|
## Layout
|
|
|
|
```text
|
|
development-gitops-argo-cd/
|
|
├── SKILL.md # Entry point — scope routing + shared rules
|
|
├── references/
|
|
│ ├── argocd-applications.md # Application manifests, sync policy, troubleshooting
|
|
│ ├── copier-templates.md # copier.yaml, .jinja authoring, render() macro
|
|
│ ├── helm-values.md # values.yaml.jinja, images, global block, probes
|
|
│ ├── environments.md # copier-answers.yaml, flags, drift, copier update
|
|
│ ├── adding-a-resource.md # End-to-end walkthrough across all three layers
|
|
│ └── cogarchhubgitops-reference.md # The CogArchHubGitOps instance
|
|
└── assets/
|
|
└── example-cluster-resource/ # Starting templates for a new resource
|
|
├── argocd/application.yaml.jinja
|
|
├── resources/values.yaml.jinja
|
|
└── copier-variables.yaml
|
|
```
|
|
|
|
## The three-layer contract
|
|
|
|
Every managed resource spans three layers that share one feature flag and one conditional
|
|
directory expression:
|
|
|
|
```text
|
|
copier.yaml → declares the flag + variables
|
|
cluster/argocd/{{ 'NNN-name' if flag }}/ → ArgoCD Application
|
|
cluster/resources/{{ 'NNN-name' if flag }}/ → Helm values
|
|
```
|
|
|
|
## Deploy
|
|
|
|
```bash
|
|
cd ../skill-manager/scripts
|
|
task deploy -- --skill-dir="$(cd ../../development-gitops-argo-cd && pwd)"
|
|
```
|
|
|
|
Built with the `skill-manager` skill, following the
|
|
[agentskills.io specification](https://agentskills.io/specification).
|