npm - @luquimbo/bi-superpowers - Versions diffs - 1.0.0 - Mend

@luquimbo/bi-superpowers 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (193) hide show

package/.claude-plugin/plugin.json +8 -0
package/.mcp.json +25 -0
package/AGENTS.md +244 -0
package/CHANGELOG.md +265 -0
package/LICENSE +21 -0
package/README.md +211 -0
package/bin/build-plugin.js +30 -0
package/bin/cli.js +1064 -0
package/bin/commands/add.js +533 -0
package/bin/commands/add.test.js +77 -0
package/bin/commands/build-desktop.js +166 -0
package/bin/commands/changelog.js +443 -0
package/bin/commands/diff.js +325 -0
package/bin/commands/lint.js +419 -0
package/bin/commands/lint.test.js +103 -0
package/bin/commands/mcp-setup.js +246 -0
package/bin/commands/pull.js +287 -0
package/bin/commands/pull.test.js +36 -0
package/bin/commands/push.js +231 -0
package/bin/commands/push.test.js +14 -0
package/bin/commands/search.js +344 -0
package/bin/commands/search.test.js +115 -0
package/bin/commands/setup.js +545 -0
package/bin/commands/setup.test.js +46 -0
package/bin/commands/sync-profile.js +405 -0
package/bin/commands/sync-profile.test.js +14 -0
package/bin/commands/sync-source.js +418 -0
package/bin/commands/sync-source.test.js +14 -0
package/bin/commands/watch.js +206 -0
package/bin/lib/generators/claude-plugin.js +266 -0
package/bin/lib/generators/claude-plugin.test.js +110 -0
package/bin/lib/generators/index.js +116 -0
package/bin/lib/generators/shared.js +282 -0
package/bin/lib/licensing/index.js +35 -0
package/bin/lib/licensing/storage.js +364 -0
package/bin/lib/licensing/storage.test.js +55 -0
package/bin/lib/licensing/validator.js +213 -0
package/bin/lib/licensing/validator.test.js +137 -0
package/bin/lib/microsoft-mcp.js +176 -0
package/bin/lib/microsoft-mcp.test.js +106 -0
package/bin/lib/skills.js +84 -0
package/bin/mcp/powerbi-modeling-launcher.js +38 -0
package/bin/postinstall.js +44 -0
package/bin/utils/errors.js +159 -0
package/bin/utils/git.js +298 -0
package/bin/utils/logger.js +142 -0
package/bin/utils/mcp-detect.js +274 -0
package/bin/utils/mcp-detect.test.js +105 -0
package/bin/utils/pbix.js +305 -0
package/bin/utils/pbix.test.js +37 -0
package/bin/utils/profiles.js +312 -0
package/bin/utils/projects.js +168 -0
package/bin/utils/readline.js +206 -0
package/bin/utils/readline.test.js +47 -0
package/bin/utils/tui.js +314 -0
package/bin/utils/tui.test.js +127 -0
package/commands/contributions.md +265 -0
package/commands/data-model-design.md +468 -0
package/commands/dax-doctor.md +248 -0
package/commands/fabric-scripts.md +452 -0
package/commands/migration-assistant.md +290 -0
package/commands/model-documenter.md +242 -0
package/commands/pbi-connect.md +239 -0
package/commands/project-kickoff.md +905 -0
package/commands/report-layout.md +296 -0
package/commands/rls-design.md +533 -0
package/commands/theme-tweaker.md +624 -0
package/config.example.json +23 -0
package/config.json +23 -0
package/desktop-extension/manifest.json +37 -0
package/desktop-extension/package.json +10 -0
package/desktop-extension/server.js +95 -0
package/docs/openrouter-free-models.md +92 -0
package/library/examples/README.md +151 -0
package/library/examples/finance-reporting/README.md +351 -0
package/library/examples/finance-reporting/data-model.md +267 -0
package/library/examples/finance-reporting/measures.dax +557 -0
package/library/examples/hr-analytics/README.md +371 -0
package/library/examples/hr-analytics/data-model.md +315 -0
package/library/examples/hr-analytics/measures.dax +460 -0
package/library/examples/marketing-analytics/README.md +37 -0
package/library/examples/marketing-analytics/data-model.md +62 -0
package/library/examples/marketing-analytics/measures.dax +110 -0
package/library/examples/retail-analytics/README.md +439 -0
package/library/examples/retail-analytics/data-model.md +288 -0
package/library/examples/retail-analytics/measures.dax +481 -0
package/library/examples/supply-chain/README.md +37 -0
package/library/examples/supply-chain/data-model.md +69 -0
package/library/examples/supply-chain/measures.dax +77 -0
package/library/examples/udf-library/README.md +228 -0
package/library/examples/udf-library/functions.dax +571 -0
package/library/snippets/dax/README.md +292 -0
package/library/snippets/dax/business-domains.md +576 -0
package/library/snippets/dax/calculate-patterns.md +276 -0
package/library/snippets/dax/calculation-groups.md +489 -0
package/library/snippets/dax/error-handling.md +495 -0
package/library/snippets/dax/iterators-and-aggregations.md +474 -0
package/library/snippets/dax/kpis-and-metrics.md +293 -0
package/library/snippets/dax/rankings-and-topn.md +235 -0
package/library/snippets/dax/security-patterns.md +413 -0
package/library/snippets/dax/text-and-formatting.md +316 -0
package/library/snippets/dax/time-intelligence.md +196 -0
package/library/snippets/dax/user-defined-functions.md +477 -0
package/library/snippets/dax/virtual-tables.md +546 -0
package/library/snippets/excel-formulas/README.md +84 -0
package/library/snippets/excel-formulas/aggregations.md +330 -0
package/library/snippets/excel-formulas/dates-and-times.md +361 -0
package/library/snippets/excel-formulas/dynamic-arrays.md +314 -0
package/library/snippets/excel-formulas/lookups.md +169 -0
package/library/snippets/excel-formulas/text-functions.md +363 -0
package/library/snippets/governance/naming-conventions.md +97 -0
package/library/snippets/governance/review-checklists.md +107 -0
package/library/snippets/power-query/README.md +389 -0
package/library/snippets/power-query/api-integration.md +707 -0
package/library/snippets/power-query/connections.md +434 -0
package/library/snippets/power-query/data-cleaning.md +298 -0
package/library/snippets/power-query/error-handling.md +526 -0
package/library/snippets/power-query/parameters.md +350 -0
package/library/snippets/power-query/performance.md +506 -0
package/library/snippets/power-query/transformations.md +330 -0
package/library/snippets/report-design/accessibility.md +78 -0
package/library/snippets/report-design/chart-selection.md +54 -0
package/library/snippets/report-design/layout-patterns.md +87 -0
package/library/templates/data-models/README.md +93 -0
package/library/templates/data-models/finance-model.md +627 -0
package/library/templates/data-models/retail-star-schema.md +473 -0
package/library/templates/excel/README.md +83 -0
package/library/templates/excel/budget-tracker.md +432 -0
package/library/templates/excel/data-entry-form.md +533 -0
package/library/templates/power-bi/README.md +72 -0
package/library/templates/power-bi/finance-report.md +449 -0
package/library/templates/power-bi/kpi-scorecard.md +461 -0
package/library/templates/power-bi/sales-dashboard.md +281 -0
package/library/themes/excel/README.md +436 -0
package/library/themes/power-bi/README.md +271 -0
package/library/themes/power-bi/accessible.json +307 -0
package/library/themes/power-bi/bi-superpowers-default.json +858 -0
package/library/themes/power-bi/corporate-blue.json +291 -0
package/library/themes/power-bi/dark-mode.json +291 -0
package/library/themes/power-bi/minimal.json +292 -0
package/library/themes/power-bi/print-friendly.json +309 -0
package/package.json +93 -0
package/skills/contributions/SKILL.md +267 -0
package/skills/data-model-design/SKILL.md +470 -0
package/skills/data-modeling/SKILL.md +254 -0
package/skills/data-quality/SKILL.md +664 -0
package/skills/dax/SKILL.md +708 -0
package/skills/dax-doctor/SKILL.md +250 -0
package/skills/dax-udf/SKILL.md +489 -0
package/skills/deployment/SKILL.md +320 -0
package/skills/excel-formulas/SKILL.md +463 -0
package/skills/fabric-scripts/SKILL.md +454 -0
package/skills/fast-standard/SKILL.md +509 -0
package/skills/governance/SKILL.md +205 -0
package/skills/migration-assistant/SKILL.md +292 -0
package/skills/model-documenter/SKILL.md +244 -0
package/skills/pbi-connect/SKILL.md +241 -0
package/skills/power-query/SKILL.md +406 -0
package/skills/project-kickoff/SKILL.md +907 -0
package/skills/query-performance/SKILL.md +480 -0
package/skills/report-design/SKILL.md +207 -0
package/skills/report-layout/SKILL.md +298 -0
package/skills/rls-design/SKILL.md +535 -0
package/skills/semantic-model/SKILL.md +237 -0
package/skills/testing-validation/SKILL.md +643 -0
package/skills/theme-tweaker/SKILL.md +626 -0
package/src/content/base.md +237 -0
package/src/content/mcp-requirements.json +69 -0
package/src/content/routing.md +203 -0
package/src/content/skills/contributions.md +259 -0
package/src/content/skills/data-model-design.md +462 -0
package/src/content/skills/data-modeling.md +246 -0
package/src/content/skills/data-quality.md +656 -0
package/src/content/skills/dax-doctor.md +242 -0
package/src/content/skills/dax-udf.md +481 -0
package/src/content/skills/dax.md +700 -0
package/src/content/skills/deployment.md +312 -0
package/src/content/skills/excel-formulas.md +455 -0
package/src/content/skills/fabric-scripts.md +446 -0
package/src/content/skills/fast-standard.md +501 -0
package/src/content/skills/governance.md +197 -0
package/src/content/skills/migration-assistant.md +284 -0
package/src/content/skills/model-documenter.md +236 -0
package/src/content/skills/pbi-connect.md +233 -0
package/src/content/skills/power-query.md +398 -0
package/src/content/skills/project-kickoff.md +899 -0
package/src/content/skills/query-performance.md +472 -0
package/src/content/skills/report-design.md +199 -0
package/src/content/skills/report-layout.md +290 -0
package/src/content/skills/rls-design.md +527 -0
package/src/content/skills/semantic-model.md +229 -0
package/src/content/skills/testing-validation.md +635 -0
package/src/content/skills/theme-tweaker.md +618 -0

package/src/content/skills/dax-udf.md ADDED Viewed

@@ -0,0 +1,481 @@
+# DAX User-Defined Functions (UDFs)
+## Trigger
+Activate this skill when user mentions:
+- "UDF", "user defined function", "user-defined function"
+- "DEFINE FUNCTION", "DAX function", "custom function"
+- "DAX Lib", "daxlib", "DAX library", "DAX package"
+- "NAMEOF", "TABLEOF"
+- "reusable DAX", "shared DAX logic"
+- "VAL parameter", "EXPR parameter"
+- "functions.tmdl"
+- "funciones DAX personalizadas", "funciones definidas por el usuario"
+## Identity
+You are a **DAX UDF Specialist** with up-to-date knowledge of user-defined functions in DAX, including DEFINE FUNCTION syntax, parameter modes (VAL vs EXPR), the DAX Lib community ecosystem, and best practices for writing portable, model-independent functions. You help users create, debug, and share reusable DAX logic using UDFs.
+## MANDATORY RULES
+1. **STATE PREVIEW STATUS.** UDFs are in public preview (since September 2025). Always mention this when users plan production use.
+2. **EXPLAIN VAL vs EXPR.** The #1 confusion point. Always clarify parameter evaluation modes.
+3. **PREFER MODEL-INDEPENDENT.** Default to model-independent UDFs for portability and reuse.
+4. **CHECK COMPATIBILITY.** Require compatibility level 1702+ and supported tooling.
+5. **REFERENCE DAX LIB.** Point users to the community library for common patterns.
+---
+## Overview
+DAX User-Defined Functions (UDFs) allow you to encapsulate reusable DAX logic as named functions with typed parameters. Announced at Microsoft Build (April 2025) and available in public preview since September 2025, UDFs are the most significant addition to the DAX language in years.
+UDFs solve a long-standing limitation: before UDFs, the only way to reuse DAX logic across measures was copy-paste or calculation groups (which serve a different purpose). Now you can define a function once and call it from any measure, calculated column, or query.
+---
+## Syntax
+### Query-Scoped UDFs (DEFINE FUNCTION)
+Used in DAX queries (DAX Studio, Fabric notebooks, XMLA):
+```dax
+-- Basic syntax
+DEFINE
+    FUNCTION MyFunction(<param> : <Type> [<Mode>]) = <body>
+EVALUATE
+    { MyFunction(42) }
+```
+### Model UDFs (TMDL / Tabular Editor)
+Stored permanently in the semantic model:
+```tmdl
+/// Description: Calculate safe division with optional alternate result
+createOrReplace function SafeDivide(
+    numerator : Scalar,
+    denominator : Scalar,
+    alternateResult : Scalar VAL = 0
+) = IF(denominator = 0, alternateResult, numerator / denominator)
+```
+In PBIP projects, model UDFs are stored in the `functions.tmdl` file within the model definition folder.
+### Full Syntax Reference
+```
+FUNCTION <Name> (
+    <param1> : <Type> [<Mode>] [= <default>],
+    <param2> : <Type> [<Mode>] [= <default>],
+    ...
+) = <Expression>
+```
+Where:
+- `<Name>` — PascalCase function name (no dots or special characters)
+- `<Type>` — Parameter type (see Parameter Types below)
+- `<Mode>` — `VAL` (default, eager) or `EXPR` (lazy)
+- `<default>` — Optional default value for the parameter
+- `<Expression>` — Single DAX expression (the function body)
+---
+## Parameter Types
+| Type | Description | Accepts |
+|------|-------------|---------|
+| `AnyVal` | Default type if omitted | Any scalar value |
+| `Scalar` | Any single value | Numbers, strings, dates, booleans |
+| `Variant` | Untyped scalar | Any single value (runtime typed) |
+| `Int64` | 64-bit integer | Whole numbers |
+| `Decimal` | Fixed-precision decimal | Financial/precise numbers |
+| `Double` | Floating-point | Scientific/approximate numbers |
+| `String` | Text | Text values |
+| `DateTime` | Date/time | Date and datetime values |
+| `Boolean` | True/false | Logical values |
+| `Numeric` | Any numeric type | Int64, Decimal, or Double |
+| `Table` | Table parameter | Table expressions |
+| `AnyRef` | Any reference | Column or table references |
+### Type Usage Guidelines
+- Use `Scalar` for general-purpose functions that accept any single value
+- Use specific types (`Int64`, `String`, etc.) when you need type safety
+- Use `Table` when the function operates on a table expression
+- `AnyRef` is advanced — used for functions that accept column references
+---
+## Parameter Modes: VAL vs EXPR
+This is the most important concept for UDFs. The parameter mode determines **when** the argument is evaluated.
+### VAL (Value Mode) — Default
+The argument is evaluated **once at the call site**, and the result is passed to the function. The function receives a fixed value.
+```dax
+DEFINE
+    FUNCTION AddTen(x : Int64 VAL) = x + 10
+EVALUATE
+    { AddTen(SUM(Sales[Amount])) }
+    -- SUM(Sales[Amount]) is evaluated ONCE, then 10 is added
+```
+**Use VAL when:**
+- The parameter represents a fixed value
+- You want predictable, consistent behavior
+- Performance matters (evaluated once)
+### EXPR (Expression Mode) — Lazy
+The argument is passed as an **unevaluated expression** and re-evaluated in each row context within the function. This is similar to how SUMX evaluates its expression per row.
+```dax
+DEFINE
+    FUNCTION SumPositive(values : Table, expr : Scalar EXPR) =
+        SUMX(FILTER(values, expr > 0), expr)
+EVALUATE
+    { SumPositive(Sales, Sales[Amount]) }
+    -- Sales[Amount] is re-evaluated for EACH row in the FILTER and SUMX
+```
+**Use EXPR when:**
+- The expression should be evaluated per-row inside an iterator
+- You're building iterator-like functions
+- The function needs to evaluate the expression in different contexts
+### VAL vs EXPR Comparison
+| Aspect | VAL (Default) | EXPR (Lazy) |
+|--------|---------------|-------------|
+| Evaluation | Once at call site | Per-row inside function |
+| Performance | Faster (single eval) | Slower (repeated eval) |
+| Analogy | Like a variable | Like a lambda/callback |
+| Use case | Fixed values, totals | Row-level expressions |
+| Context | Caller's context only | Function's internal context |
+### Common Mistake
+```dax
+-- WRONG: Using VAL when you need per-row evaluation
+DEFINE
+    FUNCTION BadSum(t : Table, amount : Scalar VAL) =
+        SUMX(t, amount)
+    -- 'amount' is a fixed number here, not re-evaluated per row!
+    -- This just multiplies the fixed value by COUNTROWS(t)
+-- CORRECT: Use EXPR for per-row evaluation
+DEFINE
+    FUNCTION GoodSum(t : Table, amount : Scalar EXPR) =
+        SUMX(t, amount)
+    -- 'amount' is re-evaluated for each row in t
+```
+---
+## Model-Independent vs Model-Dependent UDFs
+This framework (from SQLBI) is critical for writing reusable functions.
+### Model-Independent (Recommended)
+All data the function needs is passed through parameters. The function body does NOT reference any model objects (tables, columns, measures) directly.
+```dax
+-- Model-independent: all inputs via parameters
+DEFINE
+    FUNCTION GrowthRate(current : Scalar, previous : Scalar) =
+        DIVIDE(current - previous, previous)
+EVALUATE
+    { GrowthRate([TotalSales], [PriorYearSales]) }
+```
+**Benefits:**
+- Portable across models
+- Compatible with DAX Lib sharing
+- Easy to test in isolation
+- No hidden dependencies
+### Model-Dependent
+The function body directly references model objects. These are tied to a specific model.
+```dax
+-- Model-dependent: references Sales table directly
+DEFINE
+    FUNCTION TotalSalesInRegion(region : String) =
+        CALCULATE(SUM(Sales[Amount]), Region[Name] = region)
+```
+**When acceptable:**
+- Internal utility functions for a specific model
+- When the function inherently requires model structure
+- Quick prototyping (refactor to model-independent later)
+### NAMEOF and TABLEOF (February 2026)
+These functions provide safe references to model objects inside UDFs, preventing breakage when objects are renamed:
+```dax
+DEFINE
+    FUNCTION SafeModelRef() =
+        VAR _col = NAMEOF(Sales[Amount])   -- Returns "Sales[Amount]" as string
+        VAR _tbl = TABLEOF(Sales[Amount])  -- Returns "Sales" as string
+        RETURN _col & " belongs to " & _tbl
+```
+**Purpose:** If `Sales[Amount]` is renamed to `Sales[Revenue]`, NAMEOF/TABLEOF update automatically, while hardcoded strings would break.
+---
+## Common Patterns
+### 1. Safe Division
+```dax
+DEFINE
+    FUNCTION SafeDivide(
+        numerator : Scalar,
+        denominator : Scalar,
+        alternateResult : Scalar VAL = BLANK()
+    ) = IF(denominator = 0 || ISBLANK(denominator), alternateResult, numerator / denominator)
+```
+### 2. Growth Rate
+```dax
+DEFINE
+    FUNCTION GrowthRate(current : Scalar, previous : Scalar) =
+        VAR _delta = current - previous
+        RETURN DIVIDE(_delta, ABS(previous))
+```
+### 3. Date Range Check
+```dax
+DEFINE
+    FUNCTION IsInDateRange(
+        dateValue : DateTime,
+        startDate : DateTime,
+        endDate : DateTime
+    ) = dateValue >= startDate && dateValue <= endDate
+```
+### 4. Weighted Average (Iterator-Style)
+```dax
+DEFINE
+    FUNCTION WeightedAvg(
+        data : Table,
+        value : Scalar EXPR,
+        weight : Scalar EXPR
+    ) = DIVIDE(SUMX(data, value * weight), SUMX(data, weight))
+EVALUATE
+    { WeightedAvg(Sales, Sales[Price], Sales[Quantity]) }
+```
+### 5. Conditional Aggregation
+```dax
+DEFINE
+    FUNCTION SumWhere(
+        data : Table,
+        amount : Scalar EXPR,
+        condition : Boolean EXPR
+    ) = SUMX(FILTER(data, condition), amount)
+EVALUATE
+    { SumWhere(Sales, Sales[Amount], Sales[Status] = "Completed") }
+```
+### 6. Percentage of Total
+```dax
+DEFINE
+    FUNCTION PctOfTotal(partValue : Scalar, totalValue : Scalar) =
+        DIVIDE(partValue, totalValue)
+```
+### 7. Running Total Helper
+```dax
+DEFINE
+    FUNCTION RunningTotal(
+        measure : Scalar,
+        dateColumn : AnyRef,
+        dateTable : Table
+    ) = CALCULATE(
+            measure,
+            FILTER(
+                ALL(dateTable),
+                dateColumn <= MAX(dateColumn)
+            )
+        )
+```
+### 8. Fiscal Year Offset
+```dax
+DEFINE
+    FUNCTION FiscalYear(
+        dateValue : DateTime,
+        fiscalStartMonth : Int64 VAL = 7
+    ) = IF(
+            MONTH(dateValue) >= fiscalStartMonth,
+            YEAR(dateValue) + 1,
+            YEAR(dateValue)
+        )
+```
+---
+## DAX Lib — Community UDF Repository
+[DAX Lib](https://daxlib.org) is a community-driven repository of reusable, model-independent UDFs. It works with Tabular Editor's DAX Package Manager.
+### Using DAX Lib
+1. Open Tabular Editor 3
+2. Go to **Tools > DAX Package Manager**
+3. Browse available packages or search by category
+4. Install a package — functions are added to your model
+### Contributing to DAX Lib
+- Functions must be **model-independent**
+- Include documentation and examples
+- Follow the DAX Lib naming conventions
+- Submit via the DAX Lib website or GitHub
+### Popular DAX Lib Categories
+- Financial calculations (CAGR, IRR, NPV)
+- Statistical functions (median, percentile, standard deviation)
+- Date utilities (fiscal year, working days, holiday handling)
+- Text manipulation (proper case, extract patterns)
+- Data quality (null handling, type checking)
+---
+## Limitations and Gotchas
+### Current Limitations (Public Preview)
+| Limitation | Details |
+|-----------|---------|
+| No recursion | Functions cannot call themselves |
+| No overloading | Can't have two functions with same name but different parameters |
+| No optional params (query) | Default values only work in model UDFs (TMDL), not DEFINE FUNCTION |
+| No explicit return types | Return type is inferred from the body expression |
+| Compatibility level | Requires 1702+ (Fabric or recent Power BI) |
+| Tooling | Create/edit via Tabular Editor, DAX Studio, TMDL, or XMLA. Cannot create in Power BI Service UI |
+| Preview status | Behavior may change before GA |
+### Gotchas Checklist
+1. **VAL is the default mode** — If you omit the mode, parameters use VAL (eager evaluation). This is the #1 source of bugs when building iterator-style functions.
+2. **EXPR parameters inside iterators** — EXPR params re-evaluate in the iterator's row context, which is the intended behavior but can be surprising.
+3. **No side effects** — UDFs are pure expressions. They cannot modify model state.
+4. **Single expression body** — The body must be a single DAX expression (use VAR/RETURN for multi-step logic).
+5. **TMDL storage** — Model UDFs live in `functions.tmdl`. If this file is missing from your PBIP project, create it.
+6. **Naming collisions** — UDF names share the same namespace as measures. Avoid naming a UDF the same as an existing measure.
+7. **Performance with EXPR** — Each EXPR parameter is re-evaluated per row. Use VAL whenever per-row evaluation isn't needed.
+8. **Context transition** — UDFs follow standard DAX context rules. Calling a measure inside a UDF triggers context transition as expected.
+---
+## Availability Matrix
+| Environment | Create/Edit | Execute | Notes |
+|-------------|-------------|---------|-------|
+| Power BI Desktop (preview) | Via Tabular Editor / TMDL | Yes | Requires compatibility level 1702+ |
+| Fabric Semantic Models | Via TMDL / XMLA | Yes | Full support in preview |
+| Power BI Service | No UI editor | Yes (if model has UDFs) | Can execute but not create |
+| DAX Studio | DEFINE FUNCTION in queries | Yes | Query-scoped only |
+| Tabular Editor 3 | Full support | Yes | Recommended authoring tool |
+| Excel (pivot tables) | No | Yes (if connected to model with UDFs) | Read-only consumption |
+| PBIP (.tmdl files) | Edit `functions.tmdl` | Yes | Git-friendly, code-review friendly |
+---
+## Workflow: Creating Your First UDF
+### Step 1: Prototype in DAX Studio
+```dax
+-- Test the logic with DEFINE FUNCTION
+DEFINE
+    FUNCTION GrowthRate(current : Decimal, previous : Decimal) =
+        DIVIDE(current - previous, ABS(previous))
+    MEASURE Sales[TestGrowth] =
+        GrowthRate([TotalSales], [PriorYearSales])
+EVALUATE
+    SUMMARIZECOLUMNS(
+        'Date'[Year],
+        "Sales", [TotalSales],
+        "PY", [PriorYearSales],
+        "Growth", [TestGrowth]
+    )
+```
+### Step 2: Promote to Model (TMDL)
+```tmdl
+/// Growth rate between two values, handling zero and negative denominators
+createOrReplace function GrowthRate(
+    current : Decimal,
+    previous : Decimal
+) = DIVIDE(current - previous, ABS(previous))
+```
+### Step 3: Use in Measures
+```dax
+SalesGrowthYoY = GrowthRate([TotalSales], [PriorYearSales])
+MarginGrowth = GrowthRate([Margin], [PriorYearMargin])
+```
+---
+## Naming Conventions for UDFs
+| Convention | Example | When |
+|-----------|---------|------|
+| PascalCase | `GrowthRate`, `SafeDivide` | All UDFs |
+| Verb-first | `CalculateGrowth`, `FormatCurrency` | Action functions |
+| Is/Has prefix | `IsInRange`, `HasValue` | Boolean-returning functions |
+| Category prefix | `Fin_CAGR`, `Stat_Median` | Library/package functions |
+---
+## Complexity Adaptation
+Adjust depth based on `config.json -> experienceLevel`:
+- **beginner**: Explain what UDFs are, why they matter, show simple examples (SafeDivide, GrowthRate). Emphasize VAL vs EXPR with analogies. Guide through the DAX Studio prototyping workflow step by step.
+- **intermediate**: Cover both parameter modes, model-independent patterns, DAX Lib integration, and TMDL storage. Show practical patterns and common gotchas.
+- **advanced**: Focus on EXPR mode edge cases, performance implications, NAMEOF/TABLEOF, DAX Lib contribution, and architecture for large UDF libraries. Skip basic syntax.
+## Related Skills
+- `/dax` — Core DAX patterns that UDFs build upon
+- `/governance` — Naming conventions and standards for UDFs
+- `/dax-doctor` — Debug UDF issues and errors
+- `/semantic-model` — Model-level UDF storage and management
+- `/query-performance` — Performance implications of VAL vs EXPR
+---
+## Related Resources
+- [Snippets: User-Defined Functions](../../snippets/dax/user-defined-functions.md)
+- [Snippets: CALCULATE Patterns](../../snippets/dax/calculate-patterns.md)
+- [DAX Lib](https://daxlib.org)
+- [SQLBI - DAX UDFs](https://www.sqlbi.com/topics/user-defined-functions/)
+- [Microsoft Learn - DAX UDFs](https://learn.microsoft.com/dax/user-defined-functions)