lmiranda
b5d36865ee
Add single-line visual headers to 66 command files across 10 plugins: - clarity-assist (2 commands): 💬 - claude-config-maintainer (5 commands): ⚙️ - cmdb-assistant (11 commands): 🖥️ - code-sentinel (3 commands): 🔒 - contract-validator (5 commands): ✅ - data-platform (10 commands): 📊 - doc-guardian (5 commands): 📝 - git-flow (8 commands): 🔀 - pr-review (7 commands): 🔍 - viz-platform (10 commands): 🎨 Each command now displays a consistent header at execution start: ┌────────────────────────────────────────────────────────────────┐ │ [icon] PLUGIN-NAME · Command Description │ └────────────────────────────────────────────────────────────────┘ Addresses #275 (other plugin commands visual output) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
57 lines
1.5 KiB
Markdown
57 lines
1.5 KiB
Markdown
# /explain - dbt Model Explanation
|
|
|
|
## Visual Output
|
|
|
|
When executing this command, display the plugin header:
|
|
|
|
```
|
|
┌──────────────────────────────────────────────────────────────────┐
|
|
│ 📊 DATA-PLATFORM · Model Explanation │
|
|
└──────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
Then proceed with the explanation.
|
|
|
|
Explain a dbt model's purpose, dependencies, and SQL logic.
|
|
|
|
## Usage
|
|
|
|
```
|
|
/explain <model_name>
|
|
```
|
|
|
|
## Workflow
|
|
|
|
1. **Get model info**:
|
|
- Use `dbt_lineage` to get model metadata
|
|
- Extract description, tags, materialization
|
|
|
|
2. **Analyze dependencies**:
|
|
- Show upstream models (what this depends on)
|
|
- Show downstream models (what depends on this)
|
|
- Visualize as dependency tree
|
|
|
|
3. **Compile SQL**:
|
|
- Use `dbt_compile` to get rendered SQL
|
|
- Explain key transformations
|
|
|
|
4. **Report**:
|
|
- Model purpose (from description)
|
|
- Materialization strategy
|
|
- Dependency graph
|
|
- Key SQL logic explained
|
|
|
|
## Examples
|
|
|
|
```
|
|
/explain dim_customers
|
|
/explain fct_orders
|
|
```
|
|
|
|
## Available Tools
|
|
|
|
Use these MCP tools:
|
|
- `dbt_lineage` - Get model dependencies
|
|
- `dbt_compile` - Get compiled SQL
|
|
- `dbt_ls` - List related resources
|