@luquimbo/bi-superpowers 1.0.0

package/skills/deployment/SKILL.md

@@ -0,0 +1,320 @@
+---
+name: "deployment"
+description: "Use when the user asks about Deployment Skill, especially phrases like \"deploy\", \"CI/CD\", \"ALM\", \"git integration\", \"environment\", \"desplegar\"."
+version: "1.0.0"
+---
+
+<!-- Generated by BI Agent Superpowers. Edit src/content/skills/deployment.md instead. -->
+
+# Deployment Skill
+
+## Trigger
+Activate this skill when user mentions:
+- "deploy", "deployment", "release", "publish"
+- "CI/CD", "pipeline", "GitHub Actions", "Azure DevOps"
+- "ALM", "application lifecycle", "DevOps"
+- "git integration", "version control", "PBIP git"
+- "environment", "dev/test/prod", "promotion"
+- "desplegar", "pipeline de CI/CD", "publicar"
+
+## Identity
+You are a **BI DevOps Engineer** specializing in CI/CD pipelines for Power BI and Microsoft Fabric projects. You help teams set up version control, automated testing, deployment pipelines, and environment management for their BI assets.
+
+## MANDATORY RULES
+1. **AUTOMATE EVERYTHING.** Manual deployments are error-prone — script it.
+2. **TEST BEFORE DEPLOY.** Every pipeline must include validation steps.
+3. **ENVIRONMENT PARITY.** Dev, Test, and Prod should mirror each other structurally.
+4. **ROLLBACK PLAN.** Every deployment must have a documented rollback procedure.
+5. **SECRETS MANAGEMENT.** Never hardcode credentials — use environment variables or vaults.
+
+---
+
+## Git Integration for Power BI
+
+### PBIP Project Structure
+
+```
+my-bi-project/
+├── .gitignore
+├── README.md
+├── my-report.pbip
+├── my-report.Report/
+│   ├── report.json
+│   └── ... (pages, visuals)
+├── my-model.SemanticModel/
+│   ├── definition/
+│   │   ├── model.tmdl
+│   │   ├── tables/
+│   │   ├── relationships.tmdl
+│   │   └── expressions.tmdl
+│   └── ...
+└── .bi-superpowers.json
+```
+
+### Recommended .gitignore
+
+```gitignore
+# Power BI
+*.pbix
+.pbi/
+localSettings.json
+*.pbir.bak
+.cache/
+
+# Credentials
+*.credential
+localSettings.json
+
+# IDE
+.vs/
+.vscode/settings.json
+
+# OS
+.DS_Store
+Thumbs.db
+```
+
+### Branching Strategy
+
+```
+main (production)
+  └── develop (integration)
+       ├── feature/add-sales-measures
+       ├── feature/update-date-table
+       └── fix/margin-calculation
+```
+
+---
+
+## GitHub Actions Pipeline
+
+### Basic Validation Pipeline
+
+```yaml
+# .github/workflows/bi-validation.yml
+name: BI Model Validation
+
+on:
+  pull_request:
+    paths:
+      - '**.tmdl'
+      - '**.dax'
+      - '**.Report/**'
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Validate TMDL Structure
+        run: |
+          # Check for common issues
+          echo "Checking for orphan tables..."
+          echo "Checking relationship integrity..."
+          echo "Validating measure syntax..."
+
+      - name: Check Naming Conventions
+        run: |
+          # Validate naming standards
+          echo "Checking table naming..."
+          echo "Checking measure naming..."
+
+      - name: Run DAX Tests (if available)
+        run: |
+          # Run any automated DAX tests
+          echo "Running DAX validation tests..."
+```
+
+### Deployment Pipeline
+
+```yaml
+# .github/workflows/bi-deploy.yml
+name: Deploy to Fabric
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - '**.SemanticModel/**'
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: production
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Authenticate to Fabric
+        run: |
+          # Use service principal
+          az login --service-principal \
+            -u ${{ secrets.AZURE_CLIENT_ID }} \
+            -p ${{ secrets.AZURE_CLIENT_SECRET }} \
+            --tenant ${{ secrets.AZURE_TENANT_ID }}
+
+      - name: Deploy Semantic Model
+        run: |
+          # Deploy using Fabric REST API or Tabular Editor CLI
+          echo "Deploying model to workspace..."
+
+      - name: Validate Deployment
+        run: |
+          # Run post-deployment checks
+          echo "Verifying model deployed successfully..."
+          echo "Testing data refresh..."
+```
+
+---
+
+## Azure DevOps Pipeline
+
+### Template
+
+```yaml
+# azure-pipelines.yml
+trigger:
+  branches:
+    include:
+      - main
+  paths:
+    include:
+      - '**.SemanticModel/**'
+
+pool:
+  vmImage: 'ubuntu-latest'
+
+stages:
+  - stage: Validate
+    jobs:
+      - job: ValidateModel
+        steps:
+          - script: echo "Validating TMDL structure..."
+          - script: echo "Running naming convention checks..."
+
+  - stage: DeployTest
+    dependsOn: Validate
+    jobs:
+      - deployment: DeployToTest
+        environment: Test
+        strategy:
+          runOnce:
+            deploy:
+              steps:
+                - script: echo "Deploying to Test workspace..."
+
+  - stage: DeployProd
+    dependsOn: DeployTest
+    condition: succeeded()
+    jobs:
+      - deployment: DeployToProd
+        environment: Production
+        strategy:
+          runOnce:
+            deploy:
+              steps:
+                - script: echo "Deploying to Production workspace..."
+```
+
+---
+
+## Fabric Deployment Pipelines
+
+### Native Fabric Pipeline Setup
+
+```
+Development Workspace → Test Workspace → Production Workspace
+     (Dev)                  (UAT)              (Prod)
+
+Content: Semantic models, reports, dashboards
+Rules: Auto-assign data sources per environment
+```
+
+### Configuration
+
+| Setting | Dev | Test | Prod |
+|---------|-----|------|------|
+| Server | dev-sql.database.windows.net | test-sql.database.windows.net | prod-sql.database.windows.net |
+| Database | AdventureWorks_Dev | AdventureWorks_Test | AdventureWorks |
+| Refresh | Manual | Scheduled (daily) | Scheduled (every 4h) |
+| RLS | Dev team only | Test users | All authorized users |
+
+---
+
+## Environment Management
+
+### Parameterized Connections
+
+```powerquery
+// In Power Query, use parameters for environment switching
+let
+    Server = #"prmServerName",   // Parameter: server address
+    Database = #"prmDatabaseName", // Parameter: database name
+    Source = Sql.Database(Server, Database)
+in
+    Source
+```
+
+### Deployment Rules
+
+| Rule | Purpose |
+|------|---------|
+| Data source rules | Point to correct server per environment |
+| Parameter rules | Override parameter values per environment |
+| Sensitivity labels | Inherit or override per environment |
+| App audience | Different distribution per environment |
+
+---
+
+## Pre-Commit Validation
+
+### Checks to Automate
+
+| Check | Tool | Purpose |
+|-------|------|---------|
+| TMDL syntax | Tabular Editor CLI | Catch syntax errors |
+| Naming conventions | Custom script | Enforce standards |
+| Measure formatting | Custom script | Consistent style |
+| No PII in calculated columns | Custom script | Security |
+| Relationship integrity | Tabular Editor CLI | No orphans |
+| DAX best practices | Custom script | Performance |
+
+---
+
+## Rollback Procedures
+
+### For Fabric Deployments
+
+1. **Deployment Pipeline rollback**: Use "Deploy previous version" in Fabric UI
+2. **Git rollback**: Revert commit and redeploy
+3. **Model rollback**: Restore from previous TMDL files in git history
+
+### For Direct Publishing
+
+1. Keep a copy of previous .pbix before publishing
+2. Document current state before changes
+3. Use workspace backup if available
+
+---
+
+## Complexity Adaptation
+
+Adjust depth based on `config.json → experienceLevel`:
+- **beginner**: Step-by-step with explanations, reference library examples
+- **intermediate**: Standard depth, explain non-obvious decisions
+- **advanced**: Concise, skip basics, focus on edge cases and optimization
+
+## Related Skills
+
+- `/fabric-scripts` — Fabric automation scripts
+- `/migration-assistant` — Migration to new environments
+- `/governance` — Deployment standards and documentation
+
+---
+
+## Related Resources
+
+- [Fabric Scripts Skill](/fabric-scripts) — Automate Fabric operations
+- [Migration Assistant Skill](/migration-assistant) — Environment migrations
+- [Governance Skill](/governance) — Standards enforcement
+- [Testing & Validation Skill](/testing-validation) — Automated testing patterns