ark-controller-development
🎯Skillfrom mckinsey/agents-at-scale-ark
|Guides Kubernetes operator development for Ark, managing CRD generation, type modifications, and synchronization between Go types and Helm charts.
Installation
npx skills add https://github.com/mckinsey/agents-at-scale-ark --skill ark-controller-developmentSkill Details
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.
Overview
# Ark Controller Development
Guidance for developing the Ark Kubernetes operator in ark/.
When to use this skill
- Modifying Go type definitions (
api/v1alpha1/*_types.go) - Fixing CRD/Helm chart sync errors
- Adding new CRD fields or resources
CRD Generation Flow
```
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.
Fixing "CRDs out of sync" Errors
When make build fails with CRD validation errors:
```bash
cd ark
make manifests
make build
```
Key Directories
| 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 |
Common Tasks
After Modifying Types or Comments
Go type comments become CRD field descriptions:
```bash
cd ark
make manifests
make build
```
After Any Go Code Change
```bash
make lint-fix # Format and fix linting
make build # Build and validate
```
More from this repository10
Enables deploying and managing AI agent workloads across Kubernetes clusters, providing infrastructure for scaling and orchestrating intelligent agent systems.
ark-research skill from mckinsey/agents-at-scale-ark
Tracks, manages, and helps resolve Kubernetes-related issues and configurations within the Ark agentic runtime platform.
Regenerates and debugs TypeScript types across the ARK stack, handling type errors from Kubernetes CRDs to dashboard by automating type generation and custom SDK functionality.
ark-documentation skill from mckinsey/agents-at-scale-ark
Automatically identifies and proposes code-level fixes for security vulnerabilities in Kubernetes deployments using AI-powered analysis.
Configures and initializes a Kubernetes cluster with the Ark agentic runtime, installing necessary dependencies, controllers, APIs, and optional default model settings.
Defines and manages the architectural configuration and deployment specifications for agentic workloads in Kubernetes clusters using the Ark framework.
Tests and validates the functionality and performance of chainsaw-related workflows within the Ark Kubernetes agent platform.
Tests and validates the functionality, usability, and performance of the Ark dashboard and user interface components within the Kubernetes-based agentic workload platform.