4.5 KiB
4.5 KiB
Per AI Blitz Plan §claude. Layer: 1. Repo: devops-infra-helm-charts.
09 — Common tasks
Index of the procedures and skills checked into the repo. Pick the task, follow the link, run the playbook.
Procedures (deeper, multi-step, often paired with sister-repo PR)
| Task | Read |
|---|---|
| Onboard a new app to an existing cluster | ../docs/platform/procedures/onboard-app-to-cluster.md |
| Onboard a new cluster | ../docs/platform/procedures/onboard-new-cluster.md |
| Deboard / remove an app from a cluster | ../docs/platform/procedures/deboard-app.md |
| Bump a chart version (Chart.yaml deps) | ../docs/platform/procedures/update-chart-version.md |
| Cut a blue-green sibling and migrate to it | ../docs/platform/procedures/blue-green-chart-migration.md |
| Intentionally fork an upstream chart | ../docs/platform/procedures/fork-upstream-chart.md |
Skills (focused, single-task playbooks)
| Skill | Read |
|---|---|
| Bump a chart version (concise checklist) | ../skills/infra/bump-chart-version.md |
Diagnose pods stuck Pending (scheduling) |
../skills/infra/diagnose-scheduling.md |
| Onboard an app (concise checklist) | ../skills/infra/onboard-app.md |
Runbooks (failure response)
| Symptom | Read |
|---|---|
Argo CD OutOfSync → SyncFailed |
../docs/platform/runbooks/argocd-sync-failure.md |
Pods stuck Pending |
../docs/platform/runbooks/pod-pending-scheduling.md |
| Ingress 5xx after a Contour change | ../docs/platform/runbooks/ingress-down.md |
Schemas (reference while editing)
| Surface | Read |
|---|---|
helm-overrides/<cluster>/<app>/custom-values.yaml |
../docs/platform/schemas/custom-values-schema.md |
Raw <extra>.yaml sidecars in override dirs |
../docs/platform/schemas/raw-manifest-sidecar-schema.md |
Cluster-wide StorageClass / PriorityClass |
../docs/platform/schemas/storageclass-priorityclass-schema.md |
Coding guidelines
| Domain | Read |
|---|---|
| Helm values conventions | ../docs/global/coding-guidelines/helm-values.md |
| Argo CD interaction model | ../docs/global/coding-guidelines/argocd.md |
| Observability stack | ../docs/global/coding-guidelines/observability.md |
Operating discipline
| Topic | Read |
|---|---|
| Pre-flight + authoring loop | ../docs/global/agent-operations-guide.md |
| Don't-touch list | ../docs/global/SANCTITY_RULES.md |
| Layer classification | ../docs/global/AGENT_BOUNDARIES.md |
| Escalation table | ../docs/global/escalation-matrix.md |
ADRs (rationale, when you want to know why)
| ADR | Read |
|---|---|
| Why cache charts here vs pull from upstream at deploy | ../wiki/analyses/ADR-A1-cache-vs-upstream-charts.md |
Why versioned-sibling charts (-green, -vX.Y.Z, -latest) |
../wiki/analyses/ADR-A2-blue-green-sibling-pattern.md |
| Why per-cluster scheduling fields cannot be shared | ../wiki/analyses/ADR-A3-per-cluster-scheduling.md |
| Why raw manifest sidecars live next to overrides | ../wiki/analyses/ADR-A4-raw-manifest-sidecars-in-helm-overrides.md |
| Why manual Argo sync is the prod default | ../wiki/analyses/ADR-A5-manual-sync-default-for-infra.md |