ark-controller-development

Guide safe modifications to Ark Kubernetes operators and CRD resources.

413|97|Updated Aug 28, 2025
One-click install
npx skills add https://github.com/mckinsey/agents-at-scale-ark --skill ark-controller-development-mckinsey
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ark-controller-development
Source: https://github.com/mckinsey/agents-at-scale-ark/tree/main/.claude/skills/ark-controller-development
Command: npx skills add https://github.com/mckinsey/agents-at-scale-ark --skill ark-controller-development-mckinsey

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ark controller development guidance helps teams safely modify the Ark Kubernetes operator by providing best practices for CRD generation, Helm chart synchronization, and controller/webhook updates.

Core Features & Use Cases

  • Guidance for modifying Go type definitions (api/v1alpha1/*_types.go)
  • Guidance for fixing CRD/Helm chart sync errors and adding new CRD fields or resources
  • Clarifies the CRD generation flow and maintenance tasks (linting, builds)

Quick Start

Follow the CRD generation and Helm chart sync steps to begin modifying Ark controllers.

Frequently Asked Questions about ark-controller-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update Go types and CRDs for an Ark Kubernetes operator?

To fix CRD and Helm chart sync errors in Ark operators, you run the enforced CRD generation flow to regenerate schemas from Go types, ensuring the Helm chart automatically synchronizes with the updated custom resource definitions.

What is the CRD generation flow for Ark controller development?

The CRD generation flow is a mandatory process that extracts schemas from Go type definitions in api/v1alpha1/*_types.go and synchronizes them with Helm charts, ensuring custom resource definitions stay aligned with controller logic.

How do I add new CRD fields or resources to an Ark controller?

Adding new CRD fields or resources requires updating the Go type definitions first, then triggering the CRD generation flow to update the custom resource definitions, and finally synchronizing the Helm chart to reflect the new fields.

What routine maintenance tasks do I need to run when modifying Ark webhooks and controllers?

Routine maintenance tasks for modifying Ark webhooks and controllers include running linting checks and executing builds to validate code quality and ensure the operator components compile correctly before deployment.

Why does my Ark Helm chart fail to sync after updating CRD Go types?

Helm chart sync failures usually occur because the CRD generation flow was skipped or incomplete, leaving the Helm chart out of alignment with the updated Go type definitions in api/v1alpha1/*_types.go.