GCP HCP

Documentation, design decisions, and experiments for Hypershift on GCP managed service

Repository Structure

• design-decisions/ -- Architecture Decision Records (ADRs) covering all aspects of system design.
• docs/ -- Jira templates and team processes (definition of done, story/epic/feature templates).
• experiments/ -- Proofs of concept and research spikes (auth, networking, Terraform tooling, etc.).
• implementation-plans/ -- Step-by-step plans for delivering approved designs.
• incidents/ -- Incident reports and postmortems.
• slo/ -- Service Level Objective definitions and related artifacts.
• studies/ -- In-depth technical studies and analyses.

Claude Code Plugin

This repository is also a Claude Code plugin that provides skills for agents working on GCP HCP code across multiple repositories.

Skills

• gcp-hcp-architecture — topic-filtered access to design decisions, implementation plans, and architectural invariants
• add-gcp-service-account — step-by-step playbook for adding new GCP service accounts for WIF across all repos

Installation

Option 1: Permanent install (recommended)

Replace <path-to-local-clone> with the path to your local clone of this repo (e.g., ~/go/src/github.com/openshift-online/gcp-hcp):

claude plugin marketplace add <path-to-local-clone>
claude plugin install gcp-hcp@gcp-hcp

Skills are then available in every session, from any repository.

Updating (after pulling new changes):

claude plugin marketplace update gcp-hcp
claude plugin update gcp-hcp@gcp-hcp

Option 2: Per-session

claude --plugin-dir <path-to-local-clone>

License

Apache License 2.0 -- see LICENSE for details.