Explain a failure

Outcome

You understand what a resource does, why a run may have failed, and which downstream nodes are in the blast radius.

When to use this

Surface	Use when
CLI	One-shot investigation from shell or CI; pipe --json to other tools
MCP	An agent needs several follow-up queries on the same node
Web	You want lineage and execution context visually after resolving the node

Steps

1. Resolve the resource with Find a model if you only have a partial name.
2. Run explain with the full unique_id.
3. Run deps with --direction downstream for blast radius (replaces the removed impact command).
4. Optionally ask your agent to use dbt-tools-cli:describe-resource and dbt-tools-cli:trace-dependencies (downstream).

Example

dbt-tools discover --dbt-target ./target "fct_orders" --json
dbt-tools explain model.my_project.fct_orders --dbt-target ./target --json
dbt-tools deps model.my_project.fct_orders --dbt-target ./target --direction downstream --json

Replace model.my_project.fct_orders with the unique_id from discover output.

Next

• Investigate slow runs
• Investigation tour
• CLI README — explain and deps options