# mofaji/agentic-pbip-template architecture

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

- Interactive diagram: https://gitdiagram.com/mofaji/agentic-pbip-template
- Repository: https://github.com/mofaji/agentic-pbip-template

## Overview

This repository is a source-controlled Power BI PBIP starter pack with AI-oriented authoring guidance, report/model scaffolding, validation and rendered-visual review, plus prompt-based AI testing. The documented workflow is: an engineer writes a dashboard spec, edits the semantic model and report, opens the PBIP in Power BI Desktop, verifies rendered pages, then pushes to the test branch or manually runs AI testing. The graph follows README-documented capabilities and relationships; source excerpts were not available, so implementation-level calls are not inferred.

Main entry points: [`Template.pbip`](https://github.com/mofaji/agentic-pbip-template/blob/main/Template.pbip) (PBIP Entry), [`python`](https://github.com/mofaji/agentic-pbip-template/tree/main/python) (Python Utilities), [`scripts/Test-PbipBridge.ps1`](https://github.com/mofaji/agentic-pbip-template/blob/main/scripts/Test-PbipBridge.ps1) (Desktop Bridge Checks), [`.github/workflows/ai-testing.yml`](https://github.com/mofaji/agentic-pbip-template/blob/main/.github/workflows/ai-testing.yml) (AI Testing Workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Authoring Guidance"]
  node_steering["Steering Rules"]
  node_harness_digests["Harness Digests<br/>[AGENTS.md]"]
  node_skills["Power BI Skills<br/>[skills]"]
  node_specs["Dashboard Specs"]
  node_hooks["Claude Hooks"]
end

subgraph group_pbip["PBIP Artifacts"]
  node_pbip_entry["PBIP Entry<br/>[Template.pbip]"]
  node_report["Report Definition<br/>[definition]"]
  node_semantic_model["Semantic Model<br/>[definition]"]
end

subgraph group_verification["Verification"]
  node_bridge_checks["Desktop Bridge Checks"]
  node_semantic_checks["Semantic Checks"]
  node_render_review["Visual Verification<br/>[SKILL.md]"]
end

subgraph group_automation["Automation and Utilities"]
  node_ai_workflow["AI Testing Workflow<br/>[ai-testing.yml]"]
  node_python_utilities["Python Utilities"]
  node_email_reporting["Email Reporting"]
  node_db_alerts["DB Alert Emails"]
end

node_engineer(("BI Engineer"))
node_powerbi_desktop["Power BI Desktop"]

node_engineer -->|"reads rules"| node_steering
node_engineer -->|"writes spec"| node_specs
node_engineer -->|"builds model"| node_semantic_model
node_engineer -->|"builds report"| node_report
node_engineer -->|"opens project"| node_pbip_entry
node_pbip_entry -->|"opens in"| node_powerbi_desktop
node_engineer -->|"runs preflight"| node_bridge_checks
node_bridge_checks -->|"checks bridge"| node_powerbi_desktop
node_engineer -->|"checks semantics"| node_semantic_checks
node_engineer -->|"reviews rendering"| node_render_review
node_engineer -->|"triggers testing"| node_ai_workflow
node_ai_workflow -->|"tests artifacts"| node_pbip_entry
node_engineer -->|"uses guidance"| node_skills
node_engineer -->|"loads context"| node_harness_digests
node_engineer -->|"runs hooks"| node_hooks
node_python_utilities -->|"includes"| node_email_reporting
node_python_utilities -->|"includes"| node_db_alerts

click node_steering "https://github.com/mofaji/agentic-pbip-template/blob/main/copilot-instructions.md"
click node_harness_digests "https://github.com/mofaji/agentic-pbip-template/blob/main/AGENTS.md"
click node_skills "https://github.com/mofaji/agentic-pbip-template/tree/main/.claude/skills"
click node_specs "https://github.com/mofaji/agentic-pbip-template/tree/main/specs"
click node_hooks "https://github.com/mofaji/agentic-pbip-template/tree/main/scripts/hooks"
click node_pbip_entry "https://github.com/mofaji/agentic-pbip-template/blob/main/Template.pbip"
click node_report "https://github.com/mofaji/agentic-pbip-template/tree/main/Template.Report/definition"
click node_semantic_model "https://github.com/mofaji/agentic-pbip-template/tree/main/Template.SemanticModel/definition"
click node_bridge_checks "https://github.com/mofaji/agentic-pbip-template/blob/main/scripts/Test-PbipBridge.ps1"
click node_semantic_checks "https://github.com/mofaji/agentic-pbip-template/blob/main/scripts/Test-PbipSemantics.ps1"
click node_render_review "https://github.com/mofaji/agentic-pbip-template/blob/main/.claude/skills/powerbi-visual-verify/SKILL.md"
click node_ai_workflow "https://github.com/mofaji/agentic-pbip-template/blob/main/.github/workflows/ai-testing.yml"
click node_python_utilities "https://github.com/mofaji/agentic-pbip-template/tree/main/python"
click node_email_reporting "https://github.com/mofaji/agentic-pbip-template/tree/main/python/email_reporting"
click node_db_alerts "https://github.com/mofaji/agentic-pbip-template/tree/main/python/db_alerts"

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_steering,node_harness_digests,node_skills,node_specs,node_hooks toneBlue
class node_pbip_entry,node_report,node_semantic_model toneAmber
class node_bridge_checks,node_semantic_checks,node_render_review toneMint
class node_ai_workflow,node_python_utilities,node_email_reporting,node_db_alerts toneRose
class node_engineer,node_powerbi_desktop toneIndigo
```

## Components

### Authoring Guidance

- [Steering Rules](https://github.com/mofaji/agentic-pbip-template/blob/main/copilot-instructions.md): `copilot-instructions.md`
- [Harness Digests](https://github.com/mofaji/agentic-pbip-template/blob/main/AGENTS.md): `AGENTS.md`
- [Power BI Skills](https://github.com/mofaji/agentic-pbip-template/tree/main/.claude/skills): `.claude/skills`
- [Dashboard Specs](https://github.com/mofaji/agentic-pbip-template/tree/main/specs): `specs`
- [Claude Hooks](https://github.com/mofaji/agentic-pbip-template/tree/main/scripts/hooks): `scripts/hooks`

### PBIP Artifacts

- [PBIP Entry](https://github.com/mofaji/agentic-pbip-template/blob/main/Template.pbip): `Template.pbip`
- [Report Definition](https://github.com/mofaji/agentic-pbip-template/tree/main/Template.Report/definition): `Template.Report/definition`
- [Semantic Model](https://github.com/mofaji/agentic-pbip-template/tree/main/Template.SemanticModel/definition): `Template.SemanticModel/definition`

### Verification

- [Desktop Bridge Checks](https://github.com/mofaji/agentic-pbip-template/blob/main/scripts/Test-PbipBridge.ps1): `scripts/Test-PbipBridge.ps1`
- [Semantic Checks](https://github.com/mofaji/agentic-pbip-template/blob/main/scripts/Test-PbipSemantics.ps1): `scripts/Test-PbipSemantics.ps1`
- [Visual Verification](https://github.com/mofaji/agentic-pbip-template/blob/main/.claude/skills/powerbi-visual-verify/SKILL.md): `.claude/skills/powerbi-visual-verify/SKILL.md`

### Automation and Utilities

- [AI Testing Workflow](https://github.com/mofaji/agentic-pbip-template/blob/main/.github/workflows/ai-testing.yml): `.github/workflows/ai-testing.yml`
- [Python Utilities](https://github.com/mofaji/agentic-pbip-template/tree/main/python): `python`
- [Email Reporting](https://github.com/mofaji/agentic-pbip-template/tree/main/python/email_reporting): `python/email_reporting`
- [DB Alert Emails](https://github.com/mofaji/agentic-pbip-template/tree/main/python/db_alerts): `python/db_alerts`

### Other components

- **BI Engineer**
- **Power BI Desktop**

## Connections

- BI Engineer → Steering Rules: reads rules (evidence: `README.md`)
- BI Engineer → Dashboard Specs: writes spec (evidence: `README.md`)
- BI Engineer → Semantic Model: builds model (evidence: `README.md`)
- BI Engineer → Report Definition: builds report (evidence: `README.md`)
- BI Engineer → PBIP Entry: opens project (evidence: `README.md`)
- PBIP Entry → Power BI Desktop: opens in (evidence: `README.md`)
- BI Engineer → Desktop Bridge Checks: runs preflight (evidence: `README.md`)
- Desktop Bridge Checks → Power BI Desktop: checks bridge (evidence: `README.md`)
- BI Engineer → Semantic Checks: checks semantics (evidence: `README.md`)
- BI Engineer → Visual Verification: reviews rendering (evidence: `README.md`)
- BI Engineer → AI Testing Workflow: triggers testing (evidence: `README.md`)
- AI Testing Workflow → PBIP Entry: tests artifacts (evidence: `README.md`)
- BI Engineer → Power BI Skills: uses guidance (evidence: `README.md`)
- BI Engineer → Harness Digests: loads context (evidence: `README.md`)
- BI Engineer → Claude Hooks: runs hooks (evidence: `README.md`)
- Python Utilities → Email Reporting: includes (evidence: `README.md`)
- Python Utilities → DB Alert Emails: includes (evidence: `README.md`)
