@luquimbo/bi-superpowers 2.0.1 → 3.0.0

package/src/content/skills/deployment.md

@@ -1,312 +0,0 @@
-# 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