GoogleCloudPlatform/magic-modules

fix

Plan a remediation strategy after a test failure.

bug-fix-workflow

Workflow for triaging, planning, fixing, and verifying reported provider bugs.

add-list-resource-workflow

Opt resource into MMv1 list-resource generation by setting `generate_list_resource: true` and validate it locally with generated tests. Invoke when the user asks to add list-resource support for a specific MMv1 resource or to enable `generate_list_resource`…

default-workflow

Fallback workflow for general implementation and debugging tasks without a more specific workflow

prepare-pr-link

Prepares a feature branch, stages and commits changes, pushes to the user's personal fork, and generates a pre-filled GitHub comparison link for the user to review and submit a Pull Request.

deprecate-resource-or-field-workflow

Workflow for deprecating existing resources, data sources, or fields on the main branch prior to a major release.

major-release-removal-workflow

Workflow for executing resource, data source, and field removals on a major release feature branch.

test-fix-workflow

Workflow for diagnosing, fixing, and verifying failing Terraform acceptance tests from GitHub issue URLs (detecting test-failure labels), direct prompts, or log files using Failure Scenario Decision Trees.

add-iam-resources

Creates IAM resources for an existing MMv1 resource that does not yet have IAM resources.

add-fields-workflow

Workflow for adding new fields to existing MMv1 or handwritten resources.

test-failure-decision-tree

Classification decision tree and remediation strategies for diagnosing Terraform acceptance test failures across all workflows.

automate-test-triage

Skill to automatically triage failing tests by reading test-metadata status files, matching GitHub issues, and generating a multi-section failure report.

fetch-nightly-results

Skill to fetch latest nightly test results and metadata for Beta or GA providers from GCS test-metadata.

test-monitor-workflow

Workflow for fetching, triaging, analyzing, and reporting on nightly acceptance test results across Beta and GA Google Cloud Terraform providers.

intake-test-failure

Process raw failure info (GitHub issue URL, direct prompt text, GCS debug log links, or local logs) and normalize it into a clean failure payload for test fixing.

prepare-release-workflow

Prepare and cut weekly releases for both terraform-provider-google (TPG) and terraform-provider-google-beta (TPGB).

run-pre-gen-checks

Run fast static checks that don't require generating downstreams, including git submodule verification, gofmt formatting, YAML linting, template validation (version-guard and unused-tmpl), mmv1 core unit tests, internal tool unit tests, and .ci/magician unit…

schema-review

Skill for reviewing Magic Modules schemas. Currently covers the Enum vs. String decision via the knowledge base.

new-resource-workflow

Workflow specifically for creating a new resource, supporting both autogen and manual generation.

validate-provider-changes

Validate that changes to the generated providers don't introduce breaking changes or fields with missing tests or missing documentation. Use this skill when the user wants to check for breaking changes, missing tests, or missing documentation, or other…

fixing-tgc-resource-or-test-failures

Guide for Phase 6 of TGC Main Loop (Fix). Use to understand how to fix failures.

tgc-add-field-to-handwritten-resource-skill

Add a new field to an existing handwritten resource in TGC. Use when you need to extend a handwritten resource.

tgc-add-new-generated-resource-skill

Add a new generated resource to TGC. Use when you need to add a new generated resource to TGC.

tgc-add-new-handwritten-resource-skill

Add a new handwritten resource to TGC. Use when you need to add a new handwritten resource to TGC Next.

tgc-build-skill

Build TGC from magic modules. Use when you need to build TGC from magic modules.

tgc-create-pr-skill

Create a pull request for Magic Modules changes to support a TGC feature, adhering to upstream conventions, prefixing with tgc-revival, and formatting empty release notes.

tgc-fix-handwritten-resources-tests-skill

Fix integration tests for handwritten resources in TGC. Use when you need to fix integration tests for TGC.

tgc-fix-integration-tests-skill

Fix integration tests for TGC. Use when you need to fix integration tests for TGC.

tgc-run-integration-tests-skill

Run integration tests for TGC. Use when you need to run integration tests for TGC.

tgc-sync-provider

Synchronize a downstream Terraform provider repository with Magic Modules by aligning commit history and verifying parity.

qa-test-runner

Triggers the QA Test Runner subagent to reproduce failures and interpret logs.

parse-debug-logs

Parses massive Terraform debug logs into an easy-to-read outline of API delays, failures, and request payloads.

generate-provider

Executes code generation from Magic Modules into downstream Terraform providers and optionally compiles the binary.

repo-sync

Checks sync status and invokes the subagent to align repositories if needed.

triage

Gather context on a change or bug and plan the implementation.

check-sync-provider

Checks if the downstream provider repository is aligned with the correct Magic Modules base commit.

dev-overrides

Configures Terraform CLI with developer overrides to test locally built provider binaries without full Go acceptance tests, enabling rapid plan/apply cycles.

run-acctests

Executes acceptance tests (testacc) for a specific resource or suite in the provider and outputs verbose debug logs.

sync-provider

Synchronize a downstream Terraform provider repository with Magic Modules by aligning commit history and verifying parity.

verify-api-schema

Verify if an MMv1 YAML property matches the live GCP REST API JSON payload using the Discovery Documents.