dataproduct-builder-dbt — Claude Code hook: setup and usage
dataproduct-builder-dbt runs data contract linting right after file edits in dbt projects. Helps maintain ODCS, ODPS, and OpenLineage standards across your data product builds.
MIT ★ 1,596 updated 2026-10-29
.claude/settings.jsonWhat dataproduct-builder-dbt does
This hook is part of the dataproduct-builder-dbt plugin by Entropy Data. It listens to PostToolUse events matching Edit, Write, or MultiEdit. Whenever the agent modifies source files, it triggers the ${CLAUDE_PLUGIN_ROOT}/hooks/datacontract_lint.sh shell script.
The tooling supports data-product workflows on dbt. It handles project scaffolding, auditing, and connections to ODCS, ODPS, OpenLineage, plus GitHub Actions CI workflows. Because it runs after every file edit, contract errors surface immediately during code generation.
The execution depends entirely on ${CLAUDE_PLUGIN_ROOT}/hooks/datacontract_lint.sh being executable in the plugin path. Without configured dbt contracts or ODCS/ODPS definitions, the linting script will fail.
What it helps with
- lint data contracts automatically after modifying dbt models
- catch schema contract breaks on Edit, Write, or MultiEdit events
- connect dbt workflows with ODCS, ODPS, and OpenLineage checks
- prepare verified data product builds for GitHub Actions pipelines
Example prompts for the agent
- Update the staging dbt model for payments and run data contract linting.
- Add ODCS specifications to customer_churn.sql using MultiEdit.
- Audit dbt project contracts against OpenLineage guidelines.
How to install dataproduct-builder-dbt
Manually: put the files in place
.claude/settings.jsonThe hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json
Step by step, with commands for each platform: Claude Code hooks: what they are, where to configure them, how to block a risky command
Questions about dataproduct-builder-dbt
How to install dataproduct-builder-dbt in Claude Code?
Add the hook definition to your .claude/settings.json file under the hooks object, linking PostToolUse with Edit|Write|MultiEdit to ${CLAUDE_PLUGIN_ROOT}/hooks/datacontract_lint.sh.
What does dataproduct-builder-dbt do?
It oversees data product workflows in dbt, running contract linting and integrating with ODCS, ODPS, OpenLineage, and GitHub Actions.
When does datacontract_lint.sh trigger?
The script executes automatically on PostToolUse whenever Claude Code runs Edit, Write, or MultiEdit tool calls.
Source text
hooks.json · MIT
Hooks bundle shipped with the dataproduct-builder-dbt plugin for Claude Code.
Full data-product lifecycle on dbt for Entropy Data: scaffold, audit, and integrate projects with ODCS, ODPS, OpenLineage, and GitHub Actions.
Triggers on: PostToolUse.
```json
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write|MultiEdit",
"hooks": [
{
"type": "command",
"command": "${CLAUDE_PLUGIN_ROOT}/hooks/datacontract_lint.sh"
}
]
}
]
}
}
```
© Entropy Data · MIT · hashgraph-online/awesome-codex-plugins