kcc-direct-identity-implementer

name	kcc-direct-identity-implementer
description	Implement the IdentityV2 and ExternalIdentifier interfaces for a direct KCC resource. Use this when implementing IdentityV2 and refs.Ref for a resource.

KCC Direct Identity Implementer

This skill guides the implementation of the IdentityV2 and ExternalIdentifier interfaces for direct KCC resources, ensuring they follow the canonical gcpurls.Template pattern.

Inputs

• resource_kind: The KCC Kind (e.g., VertexAIExampleStore).
• template: The GCP URL template (e.g., projects/{project}/locations/{location}/exampleStores/{example_store}).
• api_version: The KCC API version.

Workflow

1. Check Identity existence: Check if apis/<service>/<api_version>/<resource_lower>_identity.go file already exist or not. We might have introduced the initial identity file when adding this resource as a reference. If the file does not exist, proceed with step 2 and skip step 3, otherwise skip step 2 and proceed with step 3.
2. Implement Identity: Create apis/<service>/<api_version>/<resource_lower>_identity.go.
   • Use identity.IdentityV2.
   • Use gcpurls.Template for URL parsing.
   • Implement ExternalIdentifier().
   • Implement ParentString() string to return the GCP parent URI (e.g., projects/{project} or projects/{project}/locations/{location})
3. ** Complete Identity Implementation**: Navigate to the existing apis/<service>/<api_version>/<resource_lower>_identity.go.
   • Use _ identity.Resource.
   • Implement ExternalIdentifier().
   • Implement ParentString() string to return the GCP parent URI (e.g., projects/{project} or projects/{project}/locations/{location})
4. Parent & Hierarchy Support:
   • Ensure the Spec struct has a ProjectRef (and Location if applicable).
   • Hierarchical Branching: If the GCP resource supports multiple hierarchies (e.g., Global and Regional), implement logic in String() and FromExternal() to handle both. Use the presence of the location field in the Spec to determine which pattern to use.

Journaling

Append any template mapping complexities (e.g., multi-parent or multi-hierarchy resources) to .gemini/journals/<service>.md using the format described in the kcc-agentic-journaler skill.