BI Dashboard — Data Analytics Dashboard Full Pipeline
An agent team collaborates to generate data warehouse design, KPI definitions, visualizations, and automated reports in one pass.
Execution Mode
Agent Team — Five agents communicate directly via SendMessage and perform cross-validation.
Agent Composition
| Agent |
File |
Role |
Type |
| data-engineer |
.claude/agents/data-engineer.md |
Warehouse design, ETL, data modeling |
general-purpose |
| kpi-designer |
.claude/agents/kpi-designer.md |
Metric definition, calculation logic, target setting |
general-purpose |
| dashboard-builder |
.claude/agents/dashboard-builder.md |
Visualization design, layout, interactions |
general-purpose |
| report-automator |
.claude/agents/report-automator.md |
Scheduled reporting, alert configuration, distribution |
general-purpose |
| bi-reviewer |
.claude/agents/bi-reviewer.md |
Consistency verification, data flow QA |
general-purpose |
Workflow
Phase 1: Preparation (performed directly by the orchestrator)
- Extract the following from user input:
- Business domain: E-commerce/SaaS/Manufacturing/Finance/Education, etc.
- Data sources: Available DB, API, file information
- Key questions: Business questions the dashboard should answer
- User tiers: Executives/team leads/practitioners — dashboard users
- Existing assets (optional): Existing KPIs, data models, reports, etc.
- Create the
_workspace/ directory at the project root
- Organize the input and save it to
_workspace/00_input.md
- If pre-existing files are available, copy them to
_workspace/ and skip the corresponding phase
- Determine the execution mode based on the scope of the request (see "Execution Modes by Request Scope" below)
Phase 2: Team Assembly and Execution
| Order |
Task |
Owner |
Dependencies |
Deliverable |
| 1 |
Data warehouse design |
data-engineer |
None |
_workspace/01_data_warehouse_design.md |
| 2 |
KPI definition |
kpi-designer |
Task 1 |
_workspace/02_kpi_definition.md |
| 3a |
Dashboard visualization |
dashboard-builder |
Tasks 1, 2 |
_workspace/03_dashboard_spec.md |
| 3b |
Report automation |
report-automator |
Task 2 |
_workspace/04_report_automation.md |
| 4 |
BI review |
bi-reviewer |
Tasks 3a, 3b |
_workspace/05_review_report.md |
Tasks 3a (dashboard) and 3b (report) run in parallel.
Inter-agent communication flow:
- data-engineer completes > passes Measure/Dimension list to kpi-designer
- kpi-designer completes > passes KPI priorities/drill-down to dashboard-builder, passes reporting schedule/thresholds to report-automator
- dashboard-builder completes > passes snapshot capture method to report-automator
- bi-reviewer cross-validates all deliverables. On CRITICAL findings, requests corrections from the relevant agent > rework > re-verify (up to 2 rounds)
Phase 3: Integration and Final Deliverables
Finalize deliverables based on the reviewer's report:
- Verify all files in
_workspace/
- Confirm that all CRITICAL findings have been addressed
- Report the final summary to the user
Execution Modes by Request Scope
| User Request Pattern |
Execution Mode |
Agents Deployed |
| "Build me a BI dashboard", "full dashboard design" |
Full pipeline |
All 5 agents |
| "Just define KPIs" |
KPI mode |
data-engineer + kpi-designer + reviewer |
| "Design a dashboard with these KPIs" (existing KPIs) |
Visualization mode |
dashboard-builder + reviewer |
| "Set up report automation" |
Report mode |
report-automator + reviewer |
| "Review this dashboard design" |
Review mode |
reviewer only |
Reusing existing files: If the user provides existing KPI lists, data models, etc., copy them to the appropriate numbered location in _workspace/ and skip the corresponding agent.
Data Transfer Protocol
| Strategy |
Method |
Purpose |
| File-based |
_workspace/ directory |
Store and share primary deliverables |
| Message-based |
SendMessage |
Real-time key information transfer, correction requests |
Error Handling
| Error Type |
Strategy |
| No data source information |
Design with domain-standard schema, specify customization points |
| Business objectives unclear |
Propose domain-standard KPI frameworks, guide selection |
| Agent failure |
Retry once > if still failing, proceed without that deliverable, note in review report |
| CRITICAL finding in review |
Request correction from relevant agent > rework > re-verify (up to 2 rounds) |
Test Scenarios
Normal Flow
Prompt: "Design a BI dashboard for an e-commerce store covering sales, customers, and inventory management"
Expected result:
- Data model: E-commerce Star Schema (fact_orders, dim_product, dim_customer, dim_date)
- KPIs: Purchase funnel (visits > cart > checkout), revenue, average order value, repurchase rate, inventory turnover
- Dashboard: Executive Summary + Sales + Customer + Inventory, 4 tabs
- Reports: Daily sales summary, weekly team report, monthly executive report
- Review: Full consistency matrix verification
Existing File Reuse Flow
Prompt: "Design a dashboard layout with this KPI list" + KPI file attached
Expected result:
- Copy existing KPIs to
_workspace/02_kpi_definition.md
- Visualization mode: Deploy dashboard-builder + reviewer
- Skip data-engineer and kpi-designer
Error Flow
Prompt: "Build a dashboard for our company"
Expected result:
- Domain/data source unknown > propose 3 common business domains, guide selection
- After selection, proceed with full pipeline based on domain-standard schema
Agent Extension Skills
| Skill |
File |
Target Agent |
Role |
| kpi-tree-builder |
.claude/skills/kpi-tree-builder/skill.md |
kpi-designer, dashboard-builder |
KPI tree decomposition methodology, domain templates, threshold setting, drill-down design |
| chart-selector |
.claude/skills/chart-selector/skill.md |
dashboard-builder, kpi-designer |
Chart type decision tree, per-chart rules, color palettes, layout principles |
1---2name: bi-dashboard3description: Full pipeline where an agent team collaborates to generate data warehouse design, KPI definitions, visualizations, and automated reports for a BI dashboard. Use this skill for requests like 'build me a BI dashboard', 'dashboard design', 'define KPIs', 'executive reporting dashboard', 'data visualization design', 'report automation', 'data warehouse design', 'build a KPI tree', 'sales dashboard', 'performance metrics framework', and other BI dashboard construction tasks. Also supports visualization or report automation when existing data models or KPI lists are available. Note: direct manipulation of BI tools (Tableau/PowerBI/Looker), database instance creation, and real-time data pipeline operation are outside the scope of this skill.4---56# BI Dashboard — Data Analytics Dashboard Full Pipeline78An agent team collaborates to generate data warehouse design, KPI definitions, visualizations, and automated reports in one pass.910## Execution Mode1112**Agent Team** — Five agents communicate directly via SendMessage and perform cross-validation.1314## Agent Composition1516| Agent | File | Role | Type |17|-------|------|------|------|18| data-engineer | `.claude/agents/data-engineer.md` | Warehouse design, ETL, data modeling | general-purpose |19| kpi-designer | `.claude/agents/kpi-designer.md` | Metric definition, calculation logic, target setting | general-purpose |20| dashboard-builder | `.claude/agents/dashboard-builder.md` | Visualization design, layout, interactions | general-purpose |21| report-automator | `.claude/agents/report-automator.md` | Scheduled reporting, alert configuration, distribution | general-purpose |22| bi-reviewer | `.claude/agents/bi-reviewer.md` | Consistency verification, data flow QA | general-purpose |2324## Workflow2526### Phase 1: Preparation (performed directly by the orchestrator)27281. Extract the following from user input:29 - **Business domain**: E-commerce/SaaS/Manufacturing/Finance/Education, etc.30 - **Data sources**: Available DB, API, file information31 - **Key questions**: Business questions the dashboard should answer32 - **User tiers**: Executives/team leads/practitioners — dashboard users33 - **Existing assets** (optional): Existing KPIs, data models, reports, etc.342. Create the `_workspace/` directory at the project root353. Organize the input and save it to `_workspace/00_input.md`364. If pre-existing files are available, copy them to `_workspace/` and skip the corresponding phase375. **Determine the execution mode** based on the scope of the request (see "Execution Modes by Request Scope" below)3839### Phase 2: Team Assembly and Execution4041| Order | Task | Owner | Dependencies | Deliverable |42|-------|------|-------|-------------|-------------|43| 1 | Data warehouse design | data-engineer | None | `_workspace/01_data_warehouse_design.md` |44| 2 | KPI definition | kpi-designer | Task 1 | `_workspace/02_kpi_definition.md` |45| 3a | Dashboard visualization | dashboard-builder | Tasks 1, 2 | `_workspace/03_dashboard_spec.md` |46| 3b | Report automation | report-automator | Task 2 | `_workspace/04_report_automation.md` |47| 4 | BI review | bi-reviewer | Tasks 3a, 3b | `_workspace/05_review_report.md` |4849Tasks 3a (dashboard) and 3b (report) run **in parallel**.5051**Inter-agent communication flow:**52- data-engineer completes > passes Measure/Dimension list to kpi-designer53- kpi-designer completes > passes KPI priorities/drill-down to dashboard-builder, passes reporting schedule/thresholds to report-automator54- dashboard-builder completes > passes snapshot capture method to report-automator55- bi-reviewer cross-validates all deliverables. On CRITICAL findings, requests corrections from the relevant agent > rework > re-verify (up to 2 rounds)5657### Phase 3: Integration and Final Deliverables5859Finalize deliverables based on the reviewer's report:60611. Verify all files in `_workspace/`622. Confirm that all CRITICAL findings have been addressed633. Report the final summary to the user6465## Execution Modes by Request Scope6667| User Request Pattern | Execution Mode | Agents Deployed |68|---------------------|---------------|----------------|69| "Build me a BI dashboard", "full dashboard design" | **Full pipeline** | All 5 agents |70| "Just define KPIs" | **KPI mode** | data-engineer + kpi-designer + reviewer |71| "Design a dashboard with these KPIs" (existing KPIs) | **Visualization mode** | dashboard-builder + reviewer |72| "Set up report automation" | **Report mode** | report-automator + reviewer |73| "Review this dashboard design" | **Review mode** | reviewer only |7475**Reusing existing files**: If the user provides existing KPI lists, data models, etc., copy them to the appropriate numbered location in `_workspace/` and skip the corresponding agent.7677## Data Transfer Protocol7879| Strategy | Method | Purpose |80|----------|--------|---------|81| File-based | `_workspace/` directory | Store and share primary deliverables |82| Message-based | SendMessage | Real-time key information transfer, correction requests |8384## Error Handling8586| Error Type | Strategy |87|-----------|----------|88| No data source information | Design with domain-standard schema, specify customization points |89| Business objectives unclear | Propose domain-standard KPI frameworks, guide selection |90| Agent failure | Retry once > if still failing, proceed without that deliverable, note in review report |91| CRITICAL finding in review | Request correction from relevant agent > rework > re-verify (up to 2 rounds) |9293## Test Scenarios9495### Normal Flow96**Prompt**: "Design a BI dashboard for an e-commerce store covering sales, customers, and inventory management"97**Expected result**:98- Data model: E-commerce Star Schema (fact_orders, dim_product, dim_customer, dim_date)99- KPIs: Purchase funnel (visits > cart > checkout), revenue, average order value, repurchase rate, inventory turnover100- Dashboard: Executive Summary + Sales + Customer + Inventory, 4 tabs101- Reports: Daily sales summary, weekly team report, monthly executive report102- Review: Full consistency matrix verification103104### Existing File Reuse Flow105**Prompt**: "Design a dashboard layout with this KPI list" + KPI file attached106**Expected result**:107- Copy existing KPIs to `_workspace/02_kpi_definition.md`108- Visualization mode: Deploy dashboard-builder + reviewer109- Skip data-engineer and kpi-designer110111### Error Flow112**Prompt**: "Build a dashboard for our company"113**Expected result**:114- Domain/data source unknown > propose 3 common business domains, guide selection115- After selection, proceed with full pipeline based on domain-standard schema116117## Agent Extension Skills118119| Skill | File | Target Agent | Role |120|-------|------|-------------|------|121| kpi-tree-builder | `.claude/skills/kpi-tree-builder/skill.md` | kpi-designer, dashboard-builder | KPI tree decomposition methodology, domain templates, threshold setting, drill-down design |122| chart-selector | `.claude/skills/chart-selector/skill.md` | dashboard-builder, kpi-designer | Chart type decision tree, per-chart rules, color palettes, layout principles |