Guidance for developing the Ark Kubernetes operator. Use when modifying Go types, CRDs, controllers, or webhooks. Helps with CRD generation and Helm chart sync issues.
/plugin marketplace add mckinsey/agents-at-scale-ark/plugin install ark@agents-at-scale-arkThis skill inherits all available tools. When active, it can use any tool Claude has access to.
Guidance for developing the Ark Kubernetes operator in ark/.
api/v1alpha1/*_types.go)api/v1alpha1/*_types.go # Go types with markers
↓
make manifests # Generates CRDs and syncs to Helm chart
↓
config/crd/bases/*.yaml # Source CRDs (auto-generated)
dist/chart/templates/crd/ # Helm chart CRDs (auto-synced)
make manifests automatically syncs source CRDs to the Helm chart while preserving templated headers.
When make build fails with CRD validation errors:
cd ark
make manifests
make build
| Directory | Purpose |
|---|---|
api/v1alpha1/ | Go type definitions |
config/crd/bases/ | Auto-generated source CRDs |
dist/chart/templates/crd/ | Helm chart CRDs (auto-synced) |
internal/controller/ | Reconciliation logic |
internal/webhook/ | Admission webhooks |
internal/genai/ | AI/ML execution logic |
Go type comments become CRD field descriptions:
cd ark
make manifests
make build
make lint-fix # Format and fix linting
make build # Build and validate
Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues.