# ruiromano/powerbi-agentic-plugins architecture

> Architecture diagram of the GitHub repository ruiromano/powerbi-agentic-plugins, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ruiromano/powerbi-agentic-plugins
- Repository: https://github.com/ruiromano/powerbi-agentic-plugins

## Overview

This repository packages Copilot plugins for Power BI authoring and Microsoft Fabric operations. The main workflow is a user prompt interpreted by Copilot with relevant skills and, for spec-driven work, architect/developer agent guidance; the resulting instructions support semantic-model creation and report authoring. Fabric skills cover workspace, item, API, job, and OneLake operations. The README documents these capabilities and plugin relationships, but no source excerpts were provided, so the graph avoids claiming implementation-level calls.

Main entry points: [`plugins/powerbi/skills/powerbi-semantic-model-authoring/SKILL.md`](https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/skills/powerbi-semantic-model-authoring/SKILL.md) (Model authoring), [`plugins/fabric/skills/fabric-cli/SKILL.md`](https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/fabric/skills/fabric-cli/SKILL.md) (Fabric CLI guidance), [`plugins/powerbi/skills/powerbi-report-authoring/SKILL.md`](https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/skills/powerbi-report-authoring/SKILL.md) (Report authoring), [`plugins/powerbi`](https://github.com/ruiromano/powerbi-agentic-plugins/tree/main/plugins/powerbi) (Power BI plugin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_powerbi["Power BI authoring"]
  node_model_skill["Model authoring<br/>[SKILL.md]"]
  node_model_guides["Modeling guides"]
  node_model_bpa["Model BPA rules"]
  node_report_skill["Report authoring<br/>[SKILL.md]"]
  node_report_template["Report template"]
  node_report_bpa["Report BPA rules"]
end

subgraph group_fabric["Fabric operations"]
  node_fabric_skill["Fabric CLI guidance<br/>[SKILL.md]"]
  node_fabric_refs["Fabric references"]
  node_fabric_definitions["Item definitions"]
end

subgraph group_plugin["Plugin guidance"]
  node_powerbi_plugin["Power BI plugin"]
  node_fabric_plugin["Fabric plugin"]
  node_architect["Architect agent"]
  node_developer["Developer agent"]
  node_powerbi_tools["Power BI tools<br/>[.mcp.json]"]
  node_fabric_tools["Fabric tools<br/>[.mcp.json]"]
end

node_user(("User"))
node_copilot["Copilot assistant"]
node_fabric_service["Fabric service"]
node_powerbi_service["Power BI service"]

node_user -->|"prompts"| node_copilot
node_copilot -->|"draws on"| node_model_skill
node_copilot -->|"draws on"| node_report_skill
node_copilot -->|"draws on"| node_fabric_skill
node_powerbi_plugin -->|"includes agents"| node_architect
node_powerbi_plugin -->|"includes agents"| node_developer
node_architect -->|"hands off spec"| node_developer
node_architect -.->|"guides planning"| node_model_skill
node_developer -.->|"guides implementation"| node_model_skill
node_model_skill -.->|"uses guidance"| node_model_guides
node_model_skill -.->|"checks models"| node_model_bpa
node_model_skill -->|"enables report"| node_report_skill
node_report_skill -.->|"authors from"| node_report_template
node_report_skill -.->|"checks reports"| node_report_bpa
node_fabric_plugin -->|"includes skill"| node_fabric_skill
node_fabric_skill -.->|"uses references"| node_fabric_refs
node_fabric_skill -.->|"uses definitions"| node_fabric_definitions
node_powerbi_plugin -->|"configures tools"| node_powerbi_tools
node_fabric_plugin -->|"configures tools"| node_fabric_tools
node_powerbi_tools -->|"connects via MCP"| node_powerbi_service
node_fabric_tools -->|"connects via MCP"| node_fabric_service
node_fabric_skill -->|"guides operations"| node_fabric_service

click node_powerbi_plugin "https://github.com/ruiromano/powerbi-agentic-plugins/tree/main/plugins/powerbi"
click node_fabric_plugin "https://github.com/ruiromano/powerbi-agentic-plugins/tree/main/plugins/fabric"
click node_architect "https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/agents/powerbi-architect.agent.md"
click node_developer "https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/agents/powerbi-developer.agent.md"
click node_model_skill "https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/skills/powerbi-semantic-model-authoring/SKILL.md"
click node_model_guides "https://github.com/ruiromano/powerbi-agentic-plugins/tree/main/plugins/powerbi/skills/powerbi-semantic-model-authoring/references"
click node_model_bpa "https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/skills/powerbi-semantic-model-authoring/scripts/bpa-rules-semanticmodel.json"
click node_report_skill "https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/skills/powerbi-report-authoring/SKILL.md"
click node_report_template "https://github.com/ruiromano/powerbi-agentic-plugins/tree/main/plugins/powerbi/skills/powerbi-report-authoring/assets/templateReport"
click node_report_bpa "https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/skills/powerbi-report-authoring/scripts/bpa-rules-report.json"
click node_fabric_skill "https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/fabric/skills/fabric-cli/SKILL.md"
click node_fabric_refs "https://github.com/ruiromano/powerbi-agentic-plugins/tree/main/plugins/fabric/skills/fabric-cli/references"
click node_fabric_definitions "https://github.com/ruiromano/powerbi-agentic-plugins/tree/main/plugins/fabric/skills/fabric-cli/assets"
click node_powerbi_tools "https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/.mcp.json"
click node_fabric_tools "https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/fabric/.mcp.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_model_skill,node_model_guides,node_model_bpa,node_report_skill,node_report_template,node_report_bpa,node_user toneBlue
class node_fabric_skill,node_fabric_refs,node_fabric_definitions toneAmber
class node_powerbi_plugin,node_fabric_plugin,node_architect,node_developer,node_powerbi_tools,node_fabric_tools toneMint
class node_copilot,node_fabric_service,node_powerbi_service toneIndigo
```

## Components

### Power BI authoring

- [Model authoring](https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/skills/powerbi-semantic-model-authoring/SKILL.md): `plugins/powerbi/skills/powerbi-semantic-model-authoring/SKILL.md`
- [Modeling guides](https://github.com/ruiromano/powerbi-agentic-plugins/tree/main/plugins/powerbi/skills/powerbi-semantic-model-authoring/references): `plugins/powerbi/skills/powerbi-semantic-model-authoring/references`
- [Model BPA rules](https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/skills/powerbi-semantic-model-authoring/scripts/bpa-rules-semanticmodel.json): `plugins/powerbi/skills/powerbi-semantic-model-authoring/scripts/bpa-rules-semanticmodel.json`
- [Report authoring](https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/skills/powerbi-report-authoring/SKILL.md): `plugins/powerbi/skills/powerbi-report-authoring/SKILL.md`
- [Report template](https://github.com/ruiromano/powerbi-agentic-plugins/tree/main/plugins/powerbi/skills/powerbi-report-authoring/assets/templateReport): `plugins/powerbi/skills/powerbi-report-authoring/assets/templateReport`
- [Report BPA rules](https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/skills/powerbi-report-authoring/scripts/bpa-rules-report.json): `plugins/powerbi/skills/powerbi-report-authoring/scripts/bpa-rules-report.json`

### Fabric operations

- [Fabric CLI guidance](https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/fabric/skills/fabric-cli/SKILL.md): `plugins/fabric/skills/fabric-cli/SKILL.md`
- [Fabric references](https://github.com/ruiromano/powerbi-agentic-plugins/tree/main/plugins/fabric/skills/fabric-cli/references): `plugins/fabric/skills/fabric-cli/references`
- [Item definitions](https://github.com/ruiromano/powerbi-agentic-plugins/tree/main/plugins/fabric/skills/fabric-cli/assets): `plugins/fabric/skills/fabric-cli/assets`

### Plugin guidance

- [Power BI plugin](https://github.com/ruiromano/powerbi-agentic-plugins/tree/main/plugins/powerbi): `plugins/powerbi`
- [Fabric plugin](https://github.com/ruiromano/powerbi-agentic-plugins/tree/main/plugins/fabric): `plugins/fabric`
- [Architect agent](https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/agents/powerbi-architect.agent.md): `plugins/powerbi/agents/powerbi-architect.agent.md`
- [Developer agent](https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/agents/powerbi-developer.agent.md): `plugins/powerbi/agents/powerbi-developer.agent.md`
- [Power BI tools](https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/powerbi/.mcp.json): `plugins/powerbi/.mcp.json`
- [Fabric tools](https://github.com/ruiromano/powerbi-agentic-plugins/blob/main/plugins/fabric/.mcp.json): `plugins/fabric/.mcp.json`

### Other components

- **User**
- **Copilot assistant**
- **Fabric service**
- **Power BI service**

## Connections

- User → Copilot assistant: prompts (evidence: `README.md`)
- Copilot assistant → Model authoring: draws on (evidence: `README.md`)
- Copilot assistant → Report authoring: draws on (evidence: `README.md`)
- Copilot assistant → Fabric CLI guidance: draws on (evidence: `README.md`)
- Power BI plugin → Architect agent: includes agents (evidence: `README.md`)
- Power BI plugin → Developer agent: includes agents (evidence: `README.md`)
- Architect agent → Developer agent: hands off spec (evidence: `README.md`)
- Architect agent → Model authoring: guides planning
- Developer agent → Model authoring: guides implementation
- Model authoring → Modeling guides: uses guidance
- Model authoring → Model BPA rules: checks models
- Model authoring → Report authoring: enables report (evidence: `README.md`)
- Report authoring → Report template: authors from
- Report authoring → Report BPA rules: checks reports
- Fabric plugin → Fabric CLI guidance: includes skill (evidence: `README.md`)
- Fabric CLI guidance → Fabric references: uses references
- Fabric CLI guidance → Item definitions: uses definitions
- Power BI plugin → Power BI tools: configures tools (evidence: `README.md`)
- Fabric plugin → Fabric tools: configures tools (evidence: `README.md`)
- Power BI tools → Power BI service: connects via MCP (evidence: `README.md`)
- Fabric tools → Fabric service: connects via MCP (evidence: `README.md`)
- Fabric CLI guidance → Fabric service: guides operations (evidence: `README.md`)
