ark-controller-development

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.

1.80x

Quality

88%

Does it follow best practices?

Impact

81%

1.80x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

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:

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:

cd ark
make manifests
make build

After Any Go Code Change

make lint-fix    # Format and fix linting
make build       # Build and validate

Repository: mckinsey/agents-at-scale-ark
Commit: f4bfd2d

Last updated: 3 days ago
Created: 3 days ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.