Report a finding back to dax-for-agents
The plugin is fixed in its own repository, never from the project you are in: not the
installed copy, not a local patch to a card. The way back is one issue on
CSalcedoDataBI/dax-for-agents, and the project carries on with its own workaround.
That repository is public. The issue is published the moment it is created and deleting it does not unpublish it. Steps 3 and 5 are not optional.
1. Is it the plugin?
File only what is about the plugin's text or scripts: a card in dax-reference, a field
note, an example, a dax-lib index entry, a skill step that was wrong or missing. A bug in
the user's model, in Power BI or in another tool is not a finding for this repository.
2. Gather the evidence
- The query that proves it, standalone:
EVALUATEwithDEFINEand literals, so it runs on any model. A query that needs the user's tables is not evidence anyone else can rerun. - What the engine returned, as a small table. Run the query yourself when a model is open; when you cannot, relay the user's numbers and write "reported by the user".
- The engine: Power BI Desktop version (or the service and its compatibility level) and the storage mode, import or DirectQuery.
- What the plugin says: search the installed plugin folder for the claim's own words to
find the card or note, then give its path inside the plugin (for a card: its bundle and
stem,
generated/bundles/functions-text.md, cardrept) and the plugin version (versionin its.claude-plugin/plugin.json). Do not propose an edit to a card undergenerated/: those are copied from Microsoft Learn, and the fix lands as a field note.
No query because it is a gap or a wrong skill step? Say what you had to measure or guess.
3. Sanitize
Rewrite, do not redact with ***:
- Tables, columns and measures become generic:
Sales[Amount],'Date'[Date],[Total]. That includes names that only hint at the client or the business, like'SalesAcme'. - No project, client or company names, no real values, no file paths, server names, ports, process ids, emails, tenant or workspace ids.
Then search the body file with your Grep tool for what slips through: [A-Za-z]:\\,
/Users/, /home/, localhost:\d+, @[\w-]+\.\w+, GUIDs
([0-9a-f]{8}-[0-9a-f]{4}-), and every table or project name you saw in this session.
Any hit: rewrite and search again.
4. Look for a duplicate
gh issue list -R CSalcedoDataBI/dax-for-agents --state all --search "<function or note name>"
Search again with the claim's most specific term (a number, an error text) when the name is
common, like FILTER or CALCULATE. Then read the candidate with gh issue view <n>:
- Same finding, new evidence (another engine version, another storage mode, a case it
missed): a comment,
gh issue comment <n> -R CSalcedoDataBI/dax-for-agents --body-file <file>, shown and approved exactly like an issue in step 5. - Same finding, nothing new: post nothing. Give the user the link and stop.
5. Show it, then file it
Write the body to a temporary file with three sections — What happens (the claim, the query, the result), Why it matters (what an agent would get wrong), Done when (a checklist). Write it in the user's language; the maintainer reads English and Spanish.
Show the user the title and the full body, say it will be public, and wait for a yes. Then, with the user's own GitHub CLI login:
gh issue create -R CSalcedoDataBI/dax-for-agents --title "<function>: <what is wrong, short>" --label bug --label documentation --body-file <file>
Labels: bug + documentation when a card or note says something the engine contradicts,
documentation alone when something is missing or unclear, enhancement for a new
capability. No gh or no login: give the user the title and body
and the link https://github.com/CSalcedoDataBI/dax-for-agents/issues/new.
6. Close
Give the user the issue link and the workaround the project is using meanwhile. Delete the temporary body file.