terradart: Skill for Claude Code

Add or update a curated Google resource

Read CONTEXT.md for vocabulary. Generation policy and pitfalls are in AGENTS.md. Do not hand-edit files under packages/terradart_google/lib/src/ — regenerate with terradart wrap.

Contents

• Inputs
• Workflow
• Override checklist
• Verification

Inputs

• schema.json with the target Terraform type (checked-in fixture or task-provided artifact).
• Optional Magic Modules YAML when semantic hints help (see tool/mm_yaml_sources.yaml).
• Do not fetch schemas ad hoc or assume terraform is installed in cloud-agent VMs unless the task provides it.

Workflow

Task progress:

• 1. Confirm the type exists in schema.json. Note the exact google_* key (do not infer from MM product file names). IAM adjuncts may be *_iam_member, *_iam_binding, or *_iam_policy. For binding/policy, set curatedDoc that states authoritative / replace semantics (yaml_loader_test.dart enforces this). Prefer *_iam_member in examples when an additive grant is enough.
• 2. Manifest: add or update one row in tool/mm_yaml_sources.yaml (upstream path or null with reason). Every curated override must have a manifest entry.
• 3. MM fixture (when upstream is set): run dart tool/sync_mm_yaml.dart for that type only if you intend to consume new MM hints in this PR.
• 4. New resource only: scaffold with terradart wrap-init (skip when editing an existing override).
• 5. Edit packages/terradart_codegen/lib/src/codegen/wrapper_overrides/yaml/<terraform_type>.yaml — keep it thin (human API decisions only).
• 5b. New barrel? Add its entry to packages/terradart_codegen/lib/src/codegen/barrels/barrels.yaml (doc: required; file: / extraExports: only when needed). Barrel files under terradart_google/lib/ are generated by wrap from the catalog — never hand-edit them; wrap fails closed on a catalog barrel with no manifest entry.
• 6. Lint: cd packages/terradart_codegen && dart run bin/terradart.dart lint-override (must exit 0).
• 7. Regenerate: dart run bin/terradart.dart wrap --only <terraform_type> ... then full wrap --check against the fixture paths in AGENTS.md Useful Commands.
• 8. Review the generated terradart_google diff (constructors, enums, sealed types, sensitive fields, barrel export).
• 9. Counts: if catalog size changed, update tool/doc_expectations.dart, catalog_count_test.dart, and wrap_command_test.dart file-count assertions in the same PR.
• 10. Wave / example: if this resource is part of a Wave release, follow terradart-ship-wave. For new *IamBinding / *IamPolicy when the sibling *IamMember is already curated and in quickstart synth, prefer tool/example_debt.yaml with iam-adjunct-debt: over extending examples; otherwise add or extend a quickstart. curatedDoc alone is not enough.
• 10b. Cost-classify (mandatory — do not skip): every Terraform type in the example synth output (including dependencies like google_storage_bucket). Before editing tool/apply_cost_denylist.yaml, call gcp-cost MCP: list_services → list_skus → get_sku_price. Record gcp-cost: SKU … (or gcp-cost: no Cloud Billing Catalog SKU after MCP lookup) plus billing-behavior: in the comment. billing-behavior: alone is only valid for *_iam_member / *_iam_binding / *_iam_policy. Hourly-billed types (e.g. VPN tunnel) → sweep_only, not safe. When unsure, leave unclassified (default-deny). CI test 13 rejects hand-wavy safe comments.
• 11. Verify: run the terradart-agent-verify workflow (tool/agent_verify.sh; add --maintainer when touching wrap-init / wrap-promote).