leo-claude-mktplace/plugins/data-platform/commands/lineage-viz.md

/lineage-viz - Mermaid Lineage Visualization

Generate Mermaid flowchart syntax for dbt model lineage.

Usage

/lineage-viz <model_name> [--direction TB|LR] [--depth N]

Workflow

1. Get lineage data:

   • Use dbt_lineage to fetch model dependencies
   • Capture upstream sources and downstream consumers

2. Build Mermaid graph:

   • Create nodes for each model/source
   • Style nodes by materialization type
   • Add directional arrows for dependencies

3. Output:

   • Render Mermaid flowchart syntax
   • Include copy-paste ready code block

Output Format

flowchart LR
    subgraph Sources
        raw_customers[(raw_customers)]
        raw_orders[(raw_orders)]
    end

    subgraph Staging
        stg_customers[stg_customers]
        stg_orders[stg_orders]
    end

    subgraph Marts
        dim_customers{{dim_customers}}
        fct_orders{{fct_orders}}
    end

    raw_customers --> stg_customers
    raw_orders --> stg_orders
    stg_customers --> dim_customers
    stg_orders --> fct_orders
    dim_customers --> fct_orders

Node Styles

Materialization	Mermaid Shape	Example
source	Cylinder [( )]	raw_data[(raw_data)]
view	Rectangle [ ]	stg_model[stg_model]
table	Double braces {{ }}	dim_model{{dim_model}}
incremental	Hexagon {{ }}	fct_model{{fct_model}}
ephemeral	Dashed [/ /]	tmp_model[/tmp_model/]

Options

Flag	Description
--direction TB	Top-to-bottom layout (default: LR = left-to-right)
--depth N	Limit lineage depth (default: unlimited)

Examples

/lineage-viz dim_customers
/lineage-viz fct_orders --direction TB
/lineage-viz rpt_revenue --depth 2

Usage Tips

1. Paste in documentation: Copy the output directly into README.md or docs
2. GitHub/GitLab rendering: Both platforms render Mermaid natively
3. Mermaid Live Editor: Paste at https://mermaid.live for interactive editing

Example Output

For /lineage-viz fct_orders:

```mermaid
flowchart LR
    %% Sources
    raw_customers[(raw_customers)]
    raw_orders[(raw_orders)]
    raw_products[(raw_products)]

    %% Staging
    stg_customers[stg_customers]
    stg_orders[stg_orders]
    stg_products[stg_products]

    %% Marts
    dim_customers{{dim_customers}}
    dim_products{{dim_products}}
    fct_orders{{fct_orders}}

    %% Dependencies
    raw_customers --> stg_customers
    raw_orders --> stg_orders
    raw_products --> stg_products
    stg_customers --> dim_customers
    stg_products --> dim_products
    stg_orders --> fct_orders
    dim_customers --> fct_orders
    dim_products --> fct_orders

    %% Highlight target model
    style fct_orders fill:#f96,stroke:#333,stroke-width:2px
```

Available Tools

Use these MCP tools:

• dbt_lineage - Get model dependencies (REQUIRED)
• dbt_ls - List dbt resources
• dbt_docs_generate - Generate full manifest if needed