dbt-helpers

Manage Architecture Decision Records (ADRs) using adr-tools. Use this to initialize, create, list, and link ADRs to document architectural evolution.

Scaffold and standardize new dbt-helpers plugins (Warehouse, Tool, or Schema). Use when starting a new plugin implementation or updating plugin discovery configuration.

Comprehensive workflow for creating, implementing, and validating Agent Skills. Use when asked to "create a new skill", "author a skill", "add a capability", or when standardizing project-specific workflows. Support for platform detection (Cursor, Claude Code, Gemini CLI, Codex) and template selection.

Set up the development environment for the project. Use when starting work on the project, when dependencies are out of sync, or to fix environment setup failures.

Implement and run End-to-End tests using golden output comparison. Use when verifying CLI behavior, plan generation, or full project execution.

Set up and run integration tests using Testcontainers. Use when testing warehouse adapters against real database engines or verifying filesystem-dependent operations.

Implement and use Nullable Infrastructure adapters for mock-free testing. Use when writing unit tests for core logic, implementing infrastructure adapters, or setting up test fixtures.

Manage and enforce path templating and naming conventions in dbt-helpers. Use when implementing PathPolicy, defining template variables, or configuring warehouse-specific defaults.

Implement and manage dbt YAML schema adapters for bi-directional mapping between dbt versions (e.g., Core 1.10+, Fusion) and the internal IR. Use when adding support for a new dbt version or implementing migration logic.

Manage and enforce dbt-helpers SDK contracts, including IR types (Catalog, Resource) and the Plan API. Use when defining interfaces, adding IR types, or implementing the Plan engine.