What you will see
After you set it up and run it, this is what each part means.
| On the screen | In simple words |
|---|---|
| Word plan | A list of unused or unusual tables, columns, measures, and relationships, with why each was flagged. |
| Shall we proceed? | A yes/no stop. Yes applies the plan. No leaves the model unchanged. You can edit the plan first. |
| After yes | Those unused objects are removed or cleaned. Visuals that still use a field are not dropped. |
Who this is for
Anyone who owns a .pbip dashboard and wants a smaller, cleaner model before review.
Before vs after
Without Semantic Forge
Hunting unused columns and measures by hand, or in a long AI chat, takes hours and still misses objects.
With Semantic Forge
One Word plan. You review it. You say yes or no. The model changes only on yes.
About 2 to 4 hours back per model
How it works
flowchart TD
A["Analyse this report and model"] --> B["Forge reads .Report + .SemanticModel"]
B --> C["Complete Word plan"]
C --> D["You review or edit"]
D --> E{"Shall we proceed?"}
E -->|No| F["Model unchanged"]
E -->|Yes| G["Apply unused tables / columns / measures / relationships"]
Setup — once
- Open Cursor on the Semantic Forge project.
- Type exactly: Setup Semantic Forge
- If it asks for a report folder, model folder, or a login, answer once.
- Ask it to analyse your dashboard (daily use below).
You are done when Forge can read your report and model and offers a Word plan.
Daily use
Ask: Analyse this report and semantic model. Write the full Word plan.
Give the .Report folder and the .SemanticModel folder when asked. After you read the plan: Yes, proceed or No.
Example
Shall we proceed with the optimization?
Plan highlights:
- Unused measure: <name> — not used on any page
- Unused column: <table>[<column>] — no visual binds to it
- Relationship with no query path
Yes = apply. No = stop.
If this happens
| If you see | Do this |
|---|---|
| Dashboard files changed | Confirm visuals still bind after unused objects are removed. Then run Semantic Scout before the PR. |
If something fails
| What you see | What to do |
|---|---|
| MCP will not start | Say Setup Semantic Forge. Restart Cursor. |
| Empty dashboard list | Onboard first: give report and model paths. |
| False unused object | Leave it in the plan as skip. Do not delete a field a visual still uses. |