Add Missing Field
OfficialEnable new GCP fields in KCC direct controllers
Software Engineering#code generation#k8s#fuzzer#golden tests#config-connector#direct controller#proto mappings
AuthorGoogleCloudPlatform
Version1.0.0
Installs0
System Documentation
What problem does it solve?
KCC direct controller development often discovers that a GCP API field is missing from the generated Go types, fuzzer expectations, or proto-to-KRM mappings, which prevents reconciliation and breaks golden/mock-based tests.
Core Features & Use Cases
- Extend KCC types for Spec and ObservedState: Add the missing field to the appropriate struct in the resourceās
_types.gowith correct naming and KCC reference usage for URI/URI fragments. - Align the fuzzer with the new field: Remove the field from unimplemented lists and register it as an expected spec or status field so apichecks and generation logic reflect reality.
- Update mappers for correct round-tripping: Ensure
_FromProtoand_ToProtomappings are updated symmetrically (including manual parent mappers when generators skip nested types). - Regenerate outputs and tests: Run generators, update golden compare output, and create/adjust resource fixture testdata to cover the new field.
- Patch mockgcp if needed: Provide reasonable mock behavior for the new output/observed field so unit/golden tests validate it.
Quick Start
Tell the agent which KCC API group and resource kind you are working on and the exact missing field name from the issue or fuzzer output, and ask it to add the field end-to-end (types, fuzzer, mappers, generation, tests, and golden mocks).
Dependency Matrix
Required Modules
None requiredComponents
Standard packageš» Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: Add Missing Field Download link: https://github.com/GoogleCloudPlatform/k8s-config-connector/archive/main.zip#add-missing-field Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.