K8s

---
name: k8s
description: "Generate production-grade Kubernetes manifests — Deployments with probes and security contexts, Services, Ingress with TLS, HPA, PDB, NetworkPolicy, ConfigMaps, Secrets — with optional Helm charts, Kustomize overlays, Istio mesh, and ArgoCD GitOps"
version: "2.0.0"
category: deploy
platforms:
  - CLAUDE_CODE
---

You are in AUTONOMOUS MODE. Do NOT ask questions. Do NOT pause for confirmation.
Execute every phase below in sequence, making decisions based on what you find.

============================================================
PHASE 0 — INPUT
============================================================

$ARGUMENTS may contain:
- `--helm` — generate a Helm chart instead of plain manifests
- `--namespace <name>` — target namespace (default: app name)
- `--replicas <n>` — initial replica count (default: 2)
- `--ingress <domain>` — configure ingress with this domain
- `--istio` — include Istio service mesh annotations
- `--argocd` — generate ArgoCD Application manifest
- `--kustomize` — generate Kustomize overlays for dev/staging/prod
- A specific resource to generate: `deployment`, `service`, `ingress`, `hpa`, `configmap`, `secret`, `pdb`
- If no arguments, generate the full manifest set as plain YAML

============================================================
PHASE 1 — APPLICATION ANALYSIS
============================================================

Scan the project to determine Kubernetes requirements:

**Container image**:
- Check for existing Dockerfile — extract EXPOSE port, HEALTHCHECK, CMD
- If no Dockerfile, note that one is needed (reference `deploy/docker` skill)
- Determine image name from: git remote URL, package.json name, go.mod module

**Ports and protocols**:
- Read application config for listen port (default: 3000/8080)
- Check for gRPC (protobuf files), WebSocket endpoints, metrics endpoint (`/metrics`)

**Resource requirements** — estimate based on stack:
- Node.js: 128Mi-512Mi memory, 100m-500m CPU
- Go: 64Mi-256Mi memory, 50m-250m CPU
- Java/Spring: 512Mi-1Gi memory, 250m-1000m CPU
- Python: 128Mi-512Mi memory, 100m-500m CPU

**Dependencies**:
- Database: detected from Prisma, SQLAlchemy, GORM, etc.
- Cache: Redis/Memcached references
- Message queues: RabbitMQ, Kafka, NATS
- External services: API calls, third-party integrations

**Health endpoints**:
- Check for `/health`, `/healthz`, `/ready`, `/readyz`, `/live`, `/livez`
- If none found, note to create them

**Environment variables**:
- Scan for `process.env.`, `os.Getenv`, `os.environ` references
- Categorize as: config (ConfigMap) vs secrets (Secret)

============================================================
PHASE 2 — GENERATE NAMESPACE AND RBAC
============================================================

Create `k8s/namespace.yml` with standard Kubernetes labels:
- `app.kubernetes.io/name`
- `app.kubernetes.io/managed-by: skill-deploy-k8s`

Create `k8s/serviceaccount.yml` with matching labels.

============================================================
PHASE 3 — GENERATE CORE MANIFESTS
============================================================

Create all manifests in `k8s/` directory (or `helm/{app-name}/templates/` if `--helm`).

**Deployment** (`k8s/deployment.yml`):
- `apiVersion: apps/v1`
- Minimum 2 replicas for HA
- Rolling update strategy: `maxSurge: 1`, `maxUnavailable: 0`
- Pod anti-affinity: prefer spreading across nodes
- Resource requests AND limits (always set both)
- Liveness probe: HTTP GET on health endpoint, `initialDelaySeconds: 15`, `periodSeconds: 10`
- Readiness probe: HTTP GET on ready endpoint, `initialDelaySeconds: 5`, `periodSeconds: 5`
- Startup probe (for slow-starting apps like Java): `failureThreshold: 30`, `periodSeconds: 10`
- `terminationGracePeriodSeconds: 30`
- Security context: `runAsNonRoot: true`, `runAsUser: 1001`, `fsGroup: 1001`, `seccompProfile: RuntimeDefault`, `allowPrivilegeEscalation: false`, `readOnlyRootFilesystem: true`, `capabilities.drop: ["ALL"]`
- Environment from ConfigMap and Secret refs
- Image pull policy: `IfNotPresent` for tagged, `Always` for `latest`

**Service** (`k8s/service.yml`):
- `type: ClusterIP` (default — use Ingress for external access)
- Target port matching container port
- Named port for service mesh compatibility

**Ingress** (`k8s/ingress.yml`, if domain provided):
- `networking.k8s.io/v1`
- TLS with cert-manager annotation: `cert-manager.io/cluster-issuer: letsencrypt-prod`
- nginx SSL redirect: `nginx.ingress.kubernetes.io/ssl-redirect: "true"`
- Path-based routing (`/` -> service)

**HPA** (`k8s/hpa.yml`):
- `autoscaling/v2`
- Min replicas: 2, Max replicas: 10
- CPU target: 70%, Memory target: 80%
- Scale-down stabilization: 300s (prevent flapping)
- Scale-up stabilization: 60s
- Scale-down policy: max 25% reduction per 60s

**PodDisruptionBudget** (`k8s/pdb.yml`):
- `minAvailable: 1` for small replica counts

**ConfigMap** (`k8s/configmap.yml`):
- Non-sensitive configuration values extracted from env analysis

**Secret** (`k8s/secret.yml`):
- Placeholder secret with `stringData` (not base64 in source)
- Clearly marked as "REPLACE BEFORE APPLYING"

**NetworkPolicy** (`k8s/networkpolicy.yml`):
- Default deny ingress
- Allow ingress only from ingress controller namespace
- Allow egress to database/cache services and DNS (kube-dns port 53)

============================================================
PHASE 4 — HELM CHART (if --helm)
============================================================

Generate Helm chart structure under `helm/{app-name}/`:
- `Chart.yaml`, `values.yaml`, `values-dev.yaml`, `values-staging.yaml`, `values-prod.yaml`
- `templates/`: deployment, service, ingress, hpa, pdb, configmap, secret, serviceaccount, networkpolicy, `_helpers.tpl`, `NOTES.txt`

**values.yaml** — parameterize all environment-specific values:
- `image.repository`, `image.tag`, `image.pullPolicy`
- `replicaCount`, `resources.requests`, `resources.limits`
- `ingress.enabled`, `ingress.hosts`, `ingress.tls`
- `autoscaling.enabled`, `autoscaling.minReplicas`, `autoscaling.maxReplicas`
- `env` as key-value map

**_helpers.tpl** — standard helper templates: `fullname`, `name`, `chart`, `labels`, `selectorLabels`

============================================================
PHASE 5 — KUSTOMIZE (if --kustomize)
============================================================

Generate Kustomize structure under `k8s/`:
- `base/` with `kustomization.yaml` and all core manifests
- `overlays/dev/` — 1 replica, lower resources, debug logging
- `overlays/staging/` — 2 replicas, production-like resources, info logging
- `overlays/prod/` — 3+ replicas, full resources, warn logging, PDB enabled

============================================================
PHASE 6 — ISTIO / SERVICE MESH (if --istio)
============================================================

- Pod annotation: `sidecar.istio.io/inject: "true"`
- Namespace label: `istio-injection: enabled`
- Generate `VirtualService` for traffic routing
- Generate `DestinationRule` for connection pool settings
- Generate `PeerAuthentication` for mTLS (STRICT mode)

============================================================
PHASE 7 — ARGOCD (if --argocd)
============================================================

Generate `argocd/application.yml`:
- Source from git remote with `targetRevision: HEAD`
- Path to k8s/ or helm/ directory
- Sync policy: automated with prune and self-heal enabled


============================================================
SELF-HEALING VALIDATION (max 2 iterations)
============================================================

After completing deployment/infrastructure changes, validate:

1. Verify all generated files are syntactically valid (YAML, JSON, HCL, Dockerfile).
2. Run validation commands if available (terraform validate, docker build --check, kubectl dry-run).
3. Verify no secrets, credentials, or sensitive values are hardcoded.
4. If validation fails, diagnose and fix the specific syntax or config error.
5. Repeat up to 2 iterations.

IF STILL FAILING after 2 iterations:
- Document what failed and the exact error
- Include partial output if available

============================================================
OUTPUT
============================================================

```
## Kubernetes Manifests Generated

### Files Created
{list all generated files with one-line descriptions}

### Resource Summary
| Resource | Name | Key Settings |
|----------|------|--------------|
| Namespace | {ns} | -- |
| Deployment | {name} | {replicas} replicas, {memory} memory |
| Service | {name} | ClusterIP, port {port} |
| Ingress | {name} | {domain}, TLS enabled |
| HPA | {name} | {min}-{max} replicas |
| PDB | {name} | minAvailable: 1 |

### Apply Commands
kubectl apply -f k8s/namespace.yml
kubectl apply -f k8s/

### Pre-Apply Checklist
- [ ] Replace placeholder secrets in k8s/secret.yml
- [ ] Verify container image is pushed to registry
- [ ] Ensure namespace exists in target cluster
- [ ] Configure cert-manager ClusterIssuer if using TLS
- [ ] Review resource limits for your workload
```

============================================================
NEXT STEPS
============================================================

1. Build and push the container image (run `deploy/docker` if needed)
2. Replace placeholder secrets with real values (or use external secrets operator)
3. Apply manifests to a dev cluster first: `kubectl apply -f k8s/ -n {namespace}`
4. Verify pods are running: `kubectl get pods -n {namespace}`
5. Check probes: `kubectl describe pod -n {namespace}`
6. Consider GitOps with ArgoCD or Flux for automated deployments (use `--argocd`)


============================================================
SELF-EVOLUTION TELEMETRY
============================================================

After producing output, record execution metadata for the /evolve pipeline.

Check if a project memory directory exists:
- Look for the project path in `~/.claude/projects/`
- If found, append to `skill-telemetry.md` in that memory directory

Entry format:
```
### /k8s — {{YYYY-MM-DD}}
- Outcome: {{SUCCESS | PARTIAL | FAILED}}
- Self-healed: {{yes — what was healed | no}}
- Iterations used: {{N}} / {{N max}}
- Bottleneck: {{phase that struggled or "none"}}
- Suggestion: {{one-line improvement idea for /evolve, or "none"}}
```

Only log if the memory directory exists. Skip silently if not found.
Keep entries concise — /evolve will parse these for skill improvement signals.

============================================================
DO NOT
============================================================

- Do NOT use `apiVersion: extensions/v1beta1` — use current stable APIs
- Do NOT set resource limits without requests (always set both)
- Do NOT use `latest` tag in deployment manifests — use specific tags or SHA digests
- Do NOT store real secrets in YAML files committed to git
- Do NOT set `replicas` in Deployment when HPA is enabled (HPA manages replicas)
- Do NOT use `hostNetwork: true` or `hostPort` without explicit justification
- Do NOT use `privileged: true` in security context
- Do NOT skip liveness/readiness probes — they are required for production
- Do NOT use `LoadBalancer` service type without considering cost — prefer `ClusterIP` + Ingress
- Do NOT overwrite existing manifests without reading them first
- Do NOT generate manifests for services not detected in the project