terraform-provider-rudderstack: Skill for Claude Code

Onboard Integration

Add a new source or destination integration to the terraform-provider-rudderstack.

Integration name: $0 Type: $1

---

Step 0: Gather Inputs

Parse positional arguments: integration name = $0, type = $1. If either is missing, ask the user:

1. Integration name — the snake_case name (e.g., webhook, slack, google_analytics).

2. Type — source or destination.

3. Config files from rudder-integrations-config — the 3 config JSON files are required. Default: fetch the latest from GitHub. The repo is public, so no auth or MCP connector is needed, and fetching main guarantees you validate against the currently published config rather than a stale local clone (a stale clone is the main cause of missed or removed fields):

   # {kind} = destinations | sources ; {name} = the integration's config folder
   cfgdir="$(mktemp -d)"   # fetch into a temp dir — never the provider checkout
   base="https://raw.githubusercontent.com/rudderlabs/rudder-integrations-config/main/src/configurations/{kind}/{name}"
   for f in db-config schema ui-config; do
     curl -fsSL "$base/$f.json" -o "$cfgdir/$f.json" || echo "MISSING: $f.json"
   done
   # then read the 3 files from $cfgdir
   

   Opt-in override — local clone: use a local checkout only if the user explicitly provides a path or asks for it, reading the 3 files from <path>/src/configurations/{kind}/{name}/.

Once you have the config files (from either source), verify all 3 exist:

• db-config.json
• schema.json
• ui-config.json

Read ALL THREE files. If any are missing (a curl printed MISSING:, or the name/kind is wrong), tell the user which are missing and stop — all three files are required.

Check for Existing Integration

Before proceeding, check if an integration with the same or a similar name already exists in the provider:

# For destinations:
ls rudderstack/integrations/destinations/destination_*{name}*.go 2>/dev/null
# For sources — check sources.go for a matching Register call:
grep -i '{name}' rudderstack/integrations/sources/sources.go 2>/dev/null