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. The adjunct's parent argument comes from - parents: iam-adjuncts in tool/reference_targets.yaml (service: api.ref); a parent whose identity input the heuristic misses gets an identity: entry there, not a customSlots override. Its member / members are typed IamPrincipal by - principals: IamPrincipal; examples pass sa.principal or .user(...) / .group(...), never a user: string.
• 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 — including one the weekly schema bump already scaffolded; its tool/curation_backlog.yaml note says so).
• 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). A migrate-shape-underivable finding means the migration manifest cannot derive a prelude helper or custom slot (#659): reshape the helper to a field-per-key encode() map literal, declare customSlots.<slot>.migrate: {kind: manual, reason: ...} when the slot is manual by design, or add a reasoned tool/migrate_manifest_debt.yaml entry — the last two are maintainer decisions, outside the Wave scope ledger.
• 7. Regenerate: dart run bin/terradart.dart wrap --only <terraform_type> ... for the wrapper, then a full wrap with --migrate-manifest — the migration manifest (packages/terradart_migrate/lib/src/manifest/google.g.dart) is a whole-registry artifact that --only skips, every curated factory adds a MigrateEntry to it, and the wrap --check lane fails while it is stale — then 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. Gated example check: if applying the new type needs an organization, an entitlement or real external inputs, bills while it exists, or leaves behind something that cannot be deleted (or a name that stays reserved), its example must be a gated example (README ## Before you apply section — see AGENTS.md Example verification). Extend the product's gated example or add one; never put such a factory into an example without that section. Cost or apply-ability is never a reason for tool/example_debt.yaml.
• 11. Verify: run the terradart-agent-verify workflow (tool/agent_verify.sh; add --maintainer when touching wrap-init / wrap-promote).