EKS GitOps Addon (Helm)

Scaffolds a new Helm-based addon into nanohype/eks-gitops. Produces the addons/<category>/<name>/values.yaml + per-env delta files (values-{development,staging,production}.yaml) following the eks-gitops Helm values pattern (base + delta-only). The Kustomize variant (used by storage-classes, priority-classes, karpenter-resources) needs a different layout and is not covered here.

Name	eks-addon
Version	0.1.0
Category	infrastructure
License	Apache-2.0
Persona	engineering
Tags	kubernetes, helm, argocd, gitops, eks, nanohype
Source	templates/eks-addon

Render it

Three front doors, one catalog. Pick whichever suits the caller.

# CLI
npx @nanohype/sdk render eks-addon --out ./my-app

# SDK
import { LocalSource, renderTemplate } from "@nanohype/sdk";
const result = await renderTemplate(source, "eks-addon", variables);

# MCP — from an agent
get_template({ name: "eks-addon" })

Prerequisites

Tool	Version	Why
helm	>=3.0	Render and lint values locally against the upstream chart
kustomize	>=5.0	Build per-env overlays via task validate
yamllint	—	Required by eks-gitops CI's lint:yaml job

Variables

Required

AddonName string

Kebab-case addon name. Becomes the directory name under addons/<category>/. Must be lowercase kebab-case starting with a letter.

ChartRepo string

Upstream Helm chart repository URL (artifacthub link or OCI registry).

ChartName string

Upstream chart name (as it appears in helm search results).

ChartVersion string

Current stable chart version (pin to specific — never floating). Look up with: helm search repo <chart>.

Optional

Category string — defaults to operations

Sync-wave category. One of: bootstrap, networking, security, observability, operations, argo-platform.

SyncWave string — defaults to 40

ArgoCD sync wave. Categories: bootstrap (0,2), networking (1), karpenter (5), security (10-12), policies (20-21), observability (30-33), operations (40-44), argo-platform (50-52).

What it produces

5 files. Placeholder names such as __APP_NAME__ are what the renderer substitutes into.

addons/__CATEGORY__/__ADDON_NAME__/values-development.yaml
addons/__CATEGORY__/__ADDON_NAME__/values-production.yaml
addons/__CATEGORY__/__ADDON_NAME__/values-staging.yaml
addons/__CATEGORY__/__ADDON_NAME__/values.yaml
README.md

Composes with

• Pairs with landing-zone-component
• Nests inside monorepo