docs: add comprehensive environment variables & ALM guide for SharePoint

- Created app-lifecycle/environment-variables-sharepoint-alm-guide.md
- Complete step-by-step checklist for setting up environment variables
- Covers SharePoint site/list configuration with Data Source type
- Includes connection references vs environment variables comparison
- Canvas app integration (automatic + manual Advanced tab methods)
- Power Automate flow integration with dynamic content
- Full deployment checklist (export, settings file, import)
- Cross-tenant deployment section for moving to different M365 tenants
- Naming conventions, best practices, and troubleshooting
- Updated app-lifecycle README with new guide reference

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: PowerAppsDarren

RESUME.md

@@ -1,55 +1,50 @@
 # RESUME.md - Project State
 
 ## Last Session
-- **Date:** 2025-12-17 (late night)
+- **Date:** 2025-12-18
 - **Model:** Claude Opus 4.5
 
 ## Current State
 
-Validator fixed, folder casing corrected. All 3 remotes in sync. GitHub Actions should now pass.
+Added comprehensive Environment Variables & ALM Guide for SharePoint solutions. All remotes in sync.
 
 **Branch:** `main`
 
-## What Was Accomplished This Session (2025-12-17 late night)
-
-### 1. Fixed Snippet Validator (GitHub Actions Failure)
-- **Problem:** 127 files failing validation with "Missing YAML front matter"
-- **Root Cause:** Validator was scanning documentation directories (ai-chats, ai-protocols, etc.) that aren't code snippets
-- **Solution:** Added exclusion lists to `tools/validate-snippets.js`:
-  - 44 excluded directories (ai-chats, ai-protocols, docs, utilities, fonts, icons, etc.)
-  - 12 excluded file patterns (readme.md, index.md, changelog.md, etc.)
-- **Result:** 199 files → 62 actual snippets validated, all passing ✅
-
-### 2. Fixed Git/GitHub Folder Casing Mismatch
-- **Problem:** GitHub showed `Communities`, `Constants`, etc. while local had lowercase
-- **Root Cause:** Windows/Git case insensitivity - Git tracked old PascalCase names
-- **Solution:** Used `git mv` two-step rename for 12 folders:
-  - Communities → communities
-  - Constants → constants
-  - Design → design
-  - Emojis → emojis
-  - Errors → errors
-  - Fonts → fonts
-  - Geocoding → geocoding
-  - Icons → icons
-  - Images → images
-  - JSON → json
-  - PowerShell → powershell
-  - Unicode-Magic → unicode-magic
+## What Was Accomplished This Session (2025-12-18)
+
+### 1. Created Environment Variables & ALM Guide
+- **File:** `app-lifecycle/environment-variables-sharepoint-alm-guide.md`
+- **Purpose:** Complete step-by-step checklist for setting up environment variables and deploying Power Platform solutions across environments and tenants
+- **Content includes:**
+  - Prerequisites checklist
+  - Environment variable types explained (Text, Number, Data Source, Secret, etc.)
+  - Connection References vs Environment Variables comparison
+  - SharePoint-specific environment variables setup (Site URL + List)
+  - Canvas app integration (automatic and manual methods)
+  - Power Automate flow integration
+  - Complete deployment checklist (export/import)
+  - Cross-tenant deployment checklist
+  - Naming conventions and best practices
+  - Troubleshooting common issues
+  - Quick reference cards
+
+### 2. Updated app-lifecycle README
+- Added new "Environment & Deployment" subcategory
+- Added guide to complete snippet index
+- Updated Recent Updates section
+- Incremented snippet count to 26
 
 ### Commits Made
-- `4e3d81f` - fix(validator): exclude documentation directories from snippet validation
-- `32933eb` - Remove obsolete string manipulation functions (pushed during sync)
-- `8d9c38c` - fix: correct folder name casing for Git consistency
+- `[pending]` - docs: add comprehensive environment variables & ALM guide for SharePoint
 
 ---
 
-## Previous Session (2025-12-17 night)
+## Previous Session (2025-12-17 late night)
 
-### Repository Reorganization Phase 2
-- Completed Gallery migration (T022-T029)
-- Completed Color files update (T042-T045 partial)
-- Added History sections to 24 modified files
+### Fixed Snippet Validator & Folder Casing
+- Fixed validator scanning documentation directories
+- Corrected 12 folder casings for Git consistency
+- Commits: `4e3d81f`, `32933eb`, `8d9c38c`
 
 ---
 
@@ -61,7 +56,7 @@ See git log for full history of reorganization work.
 
 ```
 PowerFxSnippets/
-├── app-lifecycle/          # App formulas, OnStart, OnError, etc.
+├── app-lifecycle/          # App formulas, OnStart, OnError, ALM guides
 ├── data-operations/        # Data sources and samples
 ├── functions/              # Algorithms, built-in, user-defined
 ├── integrations/           # Connectors, Power Automate
@@ -74,9 +69,9 @@ PowerFxSnippets/
 
 ## Next Steps (Pick Up Here)
 
-1. **Verify GitHub Actions passes** - Validator should now work
-2. **Continue Phase 2 migrations** from spec kit tasks
-3. **Fix broken internal links** (T202)
+1. **Continue Phase 2 migrations** from spec kit tasks
+2. **Fix broken internal links** (T202)
+3. **Add more ALM/deployment content** as needed
 
 ## Git Remotes
 

app-lifecycle/README.md

@@ -94,6 +94,14 @@ This category focuses on application-level operations and lifecycle management i
 
 **When to use**: Managing which screen users see first or implementing complex navigation flows.
 
+### Environment & Deployment
+**Purpose**: Environment variables, connection references, and ALM patterns for solution deployment.
+
+**Key Snippets:**
+- [**Environment Variables & ALM Guide**](./environment-variables-sharepoint-alm-guide.md) - Complete SharePoint deployment checklist
+
+**When to use**: Setting up configurable solutions that can be deployed across Dev/Test/Prod environments or different tenants.
+
 ## 🔍 Search & Filter
 
 ### By Technology
@@ -185,6 +193,7 @@ After mastering this category, consider:
 ## 📈 Recent Updates
 
 ### Latest Additions
+- [**Environment Variables & ALM Guide**](./environment-variables-sharepoint-alm-guide.md) - Added 2025-12-18 - Complete SharePoint deployment checklist
 - [**App.OnMessage Patterns**](../app-onmessage/app-onmessage.md) - Added 2025-12-17 - Message handling examples
 - [**Advanced Error Handling**](../app-onerror/fxapponerror-pa.yaml) - Added 2025-12-17 - Complex error scenarios
 - [**Formula Collections**](./formulas/collections/color-enum-in-named-formula.md) - Added 2025-12-17 - Color management
@@ -230,10 +239,13 @@ After mastering this category, consider:
 ### Messaging
 - [App.OnMessage](../app-onmessage/app-onmessage.md)
 
+### Environment & Deployment
+- [Environment Variables & ALM Guide](./environment-variables-sharepoint-alm-guide.md)
+
 ---
 
-**📊 Last Updated**: 2025-12-17
-**📄 Total Snippets**: 25
+**📊 Last Updated**: 2025-12-18
+**📄 Total Snippets**: 26
 **👥 Maintainers**: PowerAppsDarren
 
 ---