Add Power Fx Snippets Validator and tools

- Created package.json for project dependencies and scripts.
- Implemented validate-snippets.js for validating metadata and formatting of code snippets.
- Added functionality for YAML front matter validation, required fields check, and content validation.
- Included options for verbose logging, auto-fixing issues, and category-specific validation.
- Established a summary report for validation results, including errors and warnings.

Author: PowerAppsDarren

--new-structure-claude-code.md

@@ -0,0 +1,37 @@
+---
+name: Bug Report
+about: Report an issue with an existing snippet
+title: "[BUG] "
+labels: bug
+assignees: ''
+---
+
+## Bug Report
+
+**Snippet Location**
+Provide the path to the snippet with the issue (e.g., `02-app-architecture/app-events/onstart-error-handling.md`)
+
+**Describe the bug**
+A clear and concise description of what's wrong with the snippet.
+
+**Expected behavior**
+What should the snippet do correctly?
+
+**Current behavior**
+What's happening instead?
+
+**Steps to reproduce**
+1. Go to '...'
+2. Try to implement '...'
+3. See error
+
+**Environment**
+- Power Apps version:
+- Browser (if applicable):
+- Other relevant environment details:
+
+**Screenshots**
+If applicable, add screenshots to help explain the problem.
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/bug-report.md

@@ -0,0 +1,30 @@
+---
+name: Documentation Issue
+about: Report issues with READMEs, guides, or navigation
+title: "[DOCS] "
+labels: documentation
+assignees: ''
+---
+
+## Documentation Issue
+
+**Documentation Location**
+Provide the path to the documentation with issues (e.g., `README.md`, `02-app-architecture/README.md`)
+
+**Type of issue**
+- [ ] Missing information
+- [ ] Outdated content
+- [ ] Incorrect information
+- [ ] Poor navigation/clarity
+- [ ] Broken links
+- [ ] Formatting issues
+- [ ] Other (please specify)
+
+**Describe the issue**
+What's wrong with the documentation?
+
+**Suggested fix**
+How should it be corrected or improved?
+
+**Additional context**
+Add screenshots, links, or other context that might help.

.github/ISSUE_TEMPLATE/documentation-issue.md

@@ -0,0 +1,35 @@
+---
+name: Improvement Suggestion
+about: Suggest improvements to existing snippets or repository structure
+title: "[IMPROVEMENT] "
+labels: enhancement
+assignees: ''
+---
+
+## Improvement Suggestion
+
+**What area needs improvement?**
+- [ ] Existing snippet
+- [ ] Repository structure
+- [ ] Documentation
+- [ ] Navigation
+- [ ] Tools/Utilities
+- [ ] Other (please specify)
+
+**Location (if applicable)**
+Provide the path or location of what needs improvement.
+
+**Current situation**
+Describe what's currently implemented or how it works.
+
+**Suggested improvement**
+Describe your proposed changes or improvements.
+
+**Benefits**
+What benefits would this improvement provide?
+
+**Implementation approach**
+If you have thoughts on how to implement this, share them here.
+
+**Additional context**
+Add any other context or examples.

.github/ISSUE_TEMPLATE/improvement-suggestion.md

@@ -0,0 +1,42 @@
+---
+name: Snippet Request
+about: Request a new Power Fx code snippet
+title: "[SNIPPET] "
+labels: enhancement, snippet-request
+assignees: ''
+---
+
+## Snippet Request
+
+**What type of snippet are you requesting?**
+- [ ] App Architecture
+- [ ] User Interface
+- [ ] Data Management
+- [ ] Business Logic
+- [ ] Integration
+- [ ] Assets & Media
+- [ ] Advanced Pattern
+- [ ] Learning Resource
+- [ ] Other (please specify)
+
+**Describe the snippet you need**
+A clear and concise description of what the snippet should do.
+
+**Use case**
+Describe the specific scenario or problem this snippet would solve.
+
+**Expected code structure**
+If you have a rough idea of what the code should look like, describe it here.
+
+**Additional context**
+Add any other context, prerequisites, or related snippets here.
+
+**Difficulty level**
+- [ ] Beginner
+- [ ] Intermediate
+- [ ] Advanced
+- [ ] Expert
+
+**Would you be willing to contribute this snippet?**
+- [ ] Yes, I can provide the code
+- [ ] No, just requesting

.github/ISSUE_TEMPLATE/snippet-request.md

@@ -0,0 +1,87 @@
+name: Validate Snippets
+
+on:
+  push:
+    paths:
+      - '**/*.md'
+      - '**/*.yaml'
+  pull_request:
+    paths:
+      - '**/*.md'
+      - '**/*.yaml'
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '18'
+
+    - name: Install dependencies
+      run: |
+        npm install -g markdownlint-cli
+        npm install -g js-yaml
+
+    - name: Validate markdown formatting
+      run: |
+        find . -name "*.md" -not -path "./node_modules/*" -not -path "./_archive/*" -exec markdownlint {} \;
+
+    - name: Validate YAML front matter
+      run: |
+        #!/bin/bash
+        find . -name "*.md" -not -path "./node_modules/*" -not -path "./_archive/*" | while read file; do
+          if head -n 20 "$file" | grep -q "^---$"; then
+            echo "Validating front matter in $file"
+            # Extract front matter and validate YAML
+            awk '/^---$/ { if (++count == 2) exit; next } count == 1 { print }' "$file" | js-yaml --validate || echo "Invalid YAML in $file"
+          fi
+        done
+
+    - name: Check for required metadata fields
+      run: |
+        #!/bin/bash
+        find . -name "*.md" -not -path "./node_modules/*" -not -path "./_archive/*" -not -path "./README.md" | while read file; do
+          if head -n 20 "$file" | grep -q "^---$"; then
+            front_matter=$(awk '/^---$/ { if (++count == 2) exit; next } count == 1 { print }' "$file")
+            if ! echo "$front_matter" | grep -q "title:"; then
+              echo "Missing 'title' field in $file"
+              exit 1
+            fi
+            if ! echo "$front_matter" | grep -q "description:"; then
+              echo "Missing 'description' field in $file"
+              exit 1
+            fi
+            if ! echo "$front_matter" | grep -q "category:"; then
+              echo "Missing 'category' field in $file"
+              exit 1
+            fi
+            if ! echo "$front_matter" | grep -q "difficulty:"; then
+              echo "Missing 'difficulty' field in $file"
+              exit 1
+            fi
+          fi
+        done
+
+    - name: Validate internal links
+      run: |
+        #!/bin/bash
+        find . -name "*.md" -not -path "./node_modules/*" -not -path "./_archive/*" | while read file; do
+          # Check for broken relative links
+          grep -n "\[.*\](\.\." "$file" | while read line; do
+            link=$(echo "$line" | grep -o "\[.*\](\.\.[^)]*)" | sed 's/.*(//' | sed 's/).*//')
+            if [ -n "$link" ]; then
+              # Resolve the relative path
+              dir=$(dirname "$file")
+              target="$dir/$link"
+              if [ ! -f "$target" ] && [ ! -d "$target" ]; then
+                echo "Broken link in $file: $link"
+              fi
+            fi
+          done
+        done