rudderlabs

Installs and authenticates rudder-cli. Use when installing rudder-cli, setting up rudder cli, rudder-cli command not found, or authenticating with RudderStack

Validates, previews, and applies RudderStack resource changes via YAML specs. Use when iterating on RudderStack resources with rudder-cli - validates specs, previews changes with dry-run, and applies changes to workspaces

Imports existing RudderStack workspace resources into YAML files for git-based management. Use when importing existing RudderStack resources to CLI management and evolving them safely

Creates and manages RudderStack transformations and libraries with local testing. Use when creating, editing, or managing RudderStack transformations and transformation libraries using the Rudder CLI

Generates type-safe SDKs (Swift/Kotlin) from tracking plans with compile-time validation. Use when generating type-safe event tracking code from tracking plans using RudderTyper

Derives tracking plans from existing codebase types and structures. Use when instrumenting an existing product that wasn't well-instrumented or restructuring existing tracking.

Creates and manages events, properties, categories, and custom types for instrumentation schemas. Use when creating or managing events, properties, categories, or custom types for RudderStack instrumentation

Produces Data Graph YAML from RETL sources for Audiences. Use when designing Data Graphs, mapping RETL to entities/events, or assessing customer fit for Audiences.

Native batching framework for destination transformations. Extend BatchDestination to implement per-event transforms with automatic grouping, chunking, and response formatting.

Create the transformation logic for a new VDM V2 object-based destination. Implements record dispatch by object type and action, with batching and optional event-stream support.

Code design conventions — handler maps, dependency management, function extraction. Applied automatically — not user-invocable.

Conventions to follow when writing or modifying tests in this repo. Applied automatically — not user-invocable.

TypeScript-specific conventions — type narrowing, optional chaining, type safety. Applied automatically — not user-invocable.

Create the transformation logic for a new VDM Next audience destination. Implements record processing, identifier hashing, batching, and API request building for audience-based integrations.

Generate detailed integration documentation for a rudder-transformer destination. Use when asked to create docs, README, or documentation for a destination integration.

Enforce a disciplined TDD workflow with CRAP score monitoring. Use after writing or modifying Go code to ensure tests are written first (Red-Green-Refactor) and complexity stays low (CRAP < 8). Triggers on every code change cycle.

Guide for creating new providers in the rudder-iac project using the latest BaseProvider and BaseHandler framework. Use when building providers for new RudderStack services (data-graph, profiles, etc.) or creating providers from scratch with custom resources. Implements type-safe handlers with generics, resource lifecycle management (CRUD), remote state sync, and import/export functionality.

Apply repository-specific Go code structure and quality conventions for rudder-iac. Use when writing, refactoring, or reviewing Go code to make consistent choices about package design, interfaces, context usage, error handling, concurrency, naming, and tests. Prioritize this skill whenever multiple valid Go implementations exist and you need the most idiomatic, maintainable option for this repository.

Validate this branch's release POMs on Maven Central against the known previous baseline. Reads each module's version from the branch's RudderStackBuildConfig.kt (never from Maven's <release>/<latest>, so betas can't leak in), fetches that version's POM for all 8 modules (core, android, adjust, appsflyer, braze, facebook, firebase, sprig), compares each against the known-good baseline, and reports pass/fail. Use when the user asks to validate release POMs, check release artifacts, verify release publish, or mentions "validate release pom", "check release", "verify release".

Validate latest snapshot POMs on Maven Central against the baseline reference. Fetches the latest snapshot for all 8 modules (core, android, adjust, appsflyer, braze, facebook, firebase, sprig), compares each against the known-good baseline, and reports pass/fail with details. Use when the user asks to validate snapshots, check snapshot POMs, verify snapshot publish, or mentions "validate pom", "check snapshot", "verify snapshot".

Generates a Kotlin integration for the rudder-sdk-kotlin repo in a step-by-step manner by referencing the corresponding Java integration.

Scaffold a new RudderStack destination definition from a display name — asks for source types, category, connection modes, and message types via interactive forms, then creates db-config.json, ui-config.json, schema.json (from the canonical templates) plus the validation test-data file under src/configurations/destinations/<dir>/. Works for cloud, device, hybrid, or warehouse destinations. For Visual Data Mapper destinations use vdm-next-integration; to move an existing destination onto the accounts framework use migrate-to-accounts-framework.

Create the configuration definition for a new VDM Next (Visual Data Mapper) destination. Registers the destination, defines capabilities, and sets up authentication.

Migrate a destination to the RudderStack accounts framework by adding account definitions and updating destination config, schema, UI config, and validation tests

Run the full pre-merge verification matrix for rudder-sdk-react-native changes.

Run the full sanity-check matrix on a change to the rudderlabs/rudder-sdk-react-native repo (lint, type-check, test, lib builds, iOS build + run, Android build + run, npm audit, dry-run deploys). Use when verifying any change — dep bump, integration update, refactor, RN upgrade, PR-ready check — before merging.

Onboard a new source or destination integration to the terraform-provider-rudderstack by reading config JSON files from rudder-integrations-config and generating the .go implementation, tests, example .tf, and docs template.