Add validation workflow for example files

This workflow validates Markdown example files in the 'examples' directory for structure and required sections, and checks for epistemic labels.

Author: helixprojectai-code

.github/workflows/validate.yml

@@ -0,0 +1,110 @@
+```yaml
+name: Validate Examples
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'examples/**/*.md'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'examples/**/*.md'
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.9'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        # Add any Python dependencies here if needed
+    
+    - name: Validate example files
+      run: |
+        echo "Validating Claude-TTD framework examples..."
+        EXIT_CODE=0
+        
+        for file in examples/**/*.md; do
+          echo ""
+          echo "Checking: $file"
+          echo "----------------------------------------"
+          
+          if python scripts/validate-structure.py "$file"; then
+            echo "✅ Valid: $file"
+          else
+            echo "❌ Invalid: $file"
+            EXIT_CODE=1
+          fi
+        done
+        
+        echo ""
+        echo "========================================"
+        if [ $EXIT_CODE -eq 0 ]; then
+          echo "✅ All examples are valid"
+        else
+          echo "❌ Some examples failed validation"
+        fi
+        
+        exit $EXIT_CODE
+    
+    - name: Check for required sections
+      run: |
+        echo "Checking for required framework sections..."
+        
+        REQUIRED_SECTIONS=(
+          "EXECUTIVE SUMMARY"
+          "CLAIM VALIDATION"
+          "COMPONENT ANALYSIS"
+          "INTEGRATION PATH"
+          "ALIGNMENT CHECK"
+          "DELIVERABLES"
+          "VERIFICATION"
+        )
+        
+        EXIT_CODE=0
+        
+        for file in examples/**/*.md; do
+          echo "Checking sections in: $file"
+          
+          for section in "${REQUIRED_SECTIONS[@]}"; do
+            if ! grep -q "$section" "$file"; then
+              echo "❌ Missing section '$section' in $file"
+              EXIT_CODE=1
+            fi
+          done
+        done
+        
+        exit $EXIT_CODE
+    
+    - name: Check for epistemic labels
+      run: |
+        echo "Checking for epistemic labels (FACT/HYPOTHESIS/ASSUMPTION)..."
+        
+        EXIT_CODE=0
+        
+        for file in examples/**/*.md; do
+          if ! grep -q "FACT:" "$file"; then
+            echo "⚠️  Warning: No FACT labels in $file"
+          fi
+          
+          if ! grep -q "HYPOTHESIS:" "$file"; then
+            echo "⚠️  Warning: No HYPOTHESIS labels in $file"
+          fi
+          
+          if ! grep -q "ASSUMPTION:" "$file"; then
+            echo "⚠️  Warning: No ASSUMPTION labels in $file"
+          fi
+        done
+        
+        exit $EXIT_CODE
+```