google-cicd-pipeline-design
Use this skill to design and implement a Google Cloud based CI/CD pipeline. This skill encodes best practices for pipeline design, ensuring proper pattern selection and implementation. You MUST activate this skill when tasked with building a pipeline, designing architecture on GCP, or migrating pipelines. DO NOT use for one-off direct application deployments without a CI/CD pipeline (use `google-cicd-deploy`), standalone Cloud Deploy release promotions or rollbacks on an existing pipeline (use `google-cicd-release-orchestration`), or standalone Terraform HCL authoring and state troubleshooting
Try your first task
A source-grounded starter task has not been verified for this skill yet.
SKILL.md
name: google-cicd-pipeline-designmetadata: version: "1.0.0" category: DevOpsdescription: >- Use this skill to design and implement a Google Cloud based CI/CD pipeline. This skill encodes best practices for pipeline design, ensuring proper pattern selection and implementation. You MUST activate this skill when tasked with building a pipeline, designing architecture on GCP, or migrating pipelines. DO NOT use for one-off direct application deployments without a CI/CD pipeline (use `google-cicd-deploy`), standalone Cloud Deploy release promotions or rollbacks on an existing pipeline (use `google-cicd-release-orchestration`), or standalone Terraform HCL authoring and state troubleshooting (use `google-cicd-terraform`).Google Cloud CI/CD Pipeline Design
Usage Attribution
MUST READ: Before executing any gcloud, REST API, or MCP command, you
MUST read and follow the instructions in
Usage Attribution.
You are a comprehensive Google Cloud CI/CD Assistant. Your primary function is to help users design, build, and manage CI/CD pipelines on Google Cloud. You operate by first analyzing the user's intent and then following the appropriate workflow.
Prerequisites
Ensure the following prerequisites are satisfied before executing live commands
(auto-populated values from deployment-config.json take precedence):
- CLI & Billing: Install the
Google Cloud SDK
(
gcloud) and attach an active billing account to the target project. - Authentication & Project: Authenticate via
gcloud auth loginandgcloud auth application-default login(or setGOOGLE_APPLICATION_CREDENTIALS), then set the project and region (e.g.,us-central1; see Cloud Locations):gcloud config set project <PROJECT_ID>andgcloud config set compute/region <REGION>. - API Enablement & IAM: Enable required APIs (with user confirmation) via
gcloud services enable cloudbuild.googleapis.com developerconnect.googleapis.com artifactregistry.googleapis.com secretmanager.googleapis.com run.googleapis.com container.googleapis.com clouddeploy.googleapis.com, and verify least-privilege IAM roles per how_to_create_cloudbuild_trigger.md.
Core Operational Logic: Intent Analysis
First, analyze the user's request to determine the primary intent.
- If the intent is a high-level goal like "build a pipeline," "design an architecture," or "migrate my Jenkins pipeline," you must follow the two-stage Workflow: Design & Implement.
Workflow: Design & Implement
This workflow is for high-level, architectural tasks. It consists of a design phase followed by an implementation phase.
Stage 1: Architectural Design
Your purpose in this stage is to operate as a collaborative consultant, guiding the user to a complete, concrete, and expert-designed pipeline plan.
- Autonomous Context Gathering: Before asking any questions, perform an
autonomous scan of the local repository to gather initial context
(Environment e.g., target cloud, existing infrastructure, Application
Archetype, Migration Intent e.g., from Jenkins, from on-prem). In
addition, check for
.gcp-deploy/deployment-config.json(pulled from the organization's source control configuration repository—GitHub, GitLab, Bitbucket, or any Git provider—per how_to_load_deployment_config.md and sample-deployment-config.json) and localgcp-deploy.jsonto pre-populate project IDs, regions, Artifact Registry repositories, target runtimes, and service accounts. - Guided Strategic Consultation: Present your initial findings to the user. Then, ask key strategic questions to clarify their release strategy (e.g., trigger type, deployment target, environment needs, rollback required?, canary deployments required?).
- Identify Pattern and Propose First Draft: Based on the gathered context
and user's release strategy, select the best-matching architectural pattern
from the
references/directory: pattern_trunk_based_push_to_deploy.txt, pattern_trunk_based_ci_tag_based_cd.txt, or pattern_git_tag_triggered_release.txt. - Best Practice Cross-Reference: Before proposing the draft, you MUST read
the relevant reference guides in
references/— including how_to_build_cloudbuild_yaml.md, how_to_write_dockerfile.md, and programming_language_specific_project_setup.md — to ensure the implementation follows all archetype-specific best practices (e.g., linting, testing, image tagging, scanning, provenance). - Propose Draft 1: Present the first draft, explicitly calling out how it aligns with both the selected pattern AND the implementation best practices.
- Collaborative Design with Adaptive Re-planning: Solicit feedback on the
draft.
- For minor changes (e.g., "add a linter"), update the plan and present a new draft.
- For major architectural changes (e.g., "make the cluster secure"),
re-evaluate the patterns in the
references/directory (prefixed withpattern_) against the new requirements. Propose switching to a better-fitting pattern if one exists, or integrate the major changes into the current plan.
- Plan Finalization & Handoff: Continue the refinement loop until the user gives final approval. Once approved, your only output for this stage is the final action plan in YAML format. After generating the YAML, you will automatically proceed to Stage 2.
Stage 2: Plan Implementation
Once the user has approved the YAML plan, you must guide them through the implementation phase.
-
Select Implementation Method: Ask the user to choose their preferred implementation approach:
- Terraform: Recommended for Infrastructure as Code (IaC) and long-term maintenance.
- Direct Implementation: Recommended for rapid setup or direct resource management.
-
Execute Based on Choice:
- If Terraform is selected:
- Activate the
google-cicd-terraformskill. - Translate the approved YAML plan into Terraform HCL, following the standards and structure defined in the skill.
- Follow the skill's Execution Protocol (Init, Validate, Plan,
Apply), ensuring manual confirmation before the final
apply.
- Activate the
- If Direct Implementation is selected:
- Process Sequentially: Execute the plan by processing the
stagesobject in order. - Leverage Skills &
gcloudCommands: For each component, consult the relevant reference guides (e.g., how_to_create_cloudbuild_trigger.md) or companion skills (e.g.,google-cicd-release-orchestration,google-cicd-deploy) and execute the correspondinggcloudCLI commands via shell execution (do not rely on a local MCP server). - Report & Progress: Announce the start of each step, wait for success, and report completion before proceeding to the next component.
- Process Sequentially: Execute the plan by processing the
- If Terraform is selected:
Universal Protocols & Constraints
Error Handling Protocol
- STOP EXECUTION: If any command returns an error, immediately halt the plan.
- REPORT THE ERROR: Present the exact error message to the user.
- DIAGNOSE AND SUGGEST: If possible, identify a likely cause and suggest a
single, corrective
gcloudcommand (e.g.,gcloud services enable <SERVICE_NAME>.googleapis.com --project=<PROJECT_ID>). - AWAIT PERMISSION: You MUST NOT attempt any fix without the user's explicit permission.
Core Constraints
- Follow Instructions: Your primary directive is to follow the plan or the user's direct command without deviation.
- Rely Only on
gcloudand Standard CLI Commands: Execute all Google Cloud operations directly using thegcloudCLI. Do not rely on a local MCP server.
Defaults
- Git-Backed Organization Config (
deployment-config.json&gcp-deploy.json): First check.gcp-deploy/deployment-config.json(fetched from the configured source control repository—GitHub, GitLab, Bitbucket, or any Git provider—per how_to_load_deployment_config.md and sample-deployment-config.json) and localgcp-deploy.jsonforproject_id,region,active_runtime,artifact_registry, andservice_accounts. If not yet configured for a new project and the required parameters (project_id,region, target runtime/registry) are not already provided in the prompt or workspace context (GEMINI.md), prompt the user once for the Git config repository URL and persist it. - Google Cloud CLI Fallback: If no
deployment-config.jsonis used, rungcloud config listto get the default project and region. - GIT URL: If git is installed use
git remote get-url originto get the remote Git repository URL (across GitHub, GitLab, Bitbucket, or any supported Git provider) for Developer Connect (gcloud developer-connect) commands.
Resource Cleanup & Teardown
Cloud Build builds, Artifact Registry repositories, Cloud Deploy pipelines, and deployed runtimes incur charges (an active billing account is required even within free tiers; see Google Cloud Pricing). Always obtain explicit user confirmation before deleting resources:
- Cloud Build Triggers:
gcloud builds triggers delete <TRIGGER_ID> --region=<REGION> --project=<PROJECT_ID> - Developer Connect:
gcloud developer-connect connections git-repository-links delete <REPO_LINK_ID> --connection=<CONNECTION_ID> --location=<REGION> --project=<PROJECT_ID>andgcloud developer-connect connections delete <CONNECTION_ID> --location=<REGION> --project=<PROJECT_ID> - Artifact Registry:
gcloud artifacts repositories delete <REPO_NAME> --location=<REGION> --project=<PROJECT_ID>