refactor: replace Draw.io diagrams with high-level Mermaid diagrams

- Remove Draw.io files for better version control
- Add high-level architecture diagram with AWS/Azure components
- Add deployment flow diagrams for dev, staging, and production
- Use Mermaid syntax for better GitHub integration and visibility
- Include comprehensive documentation for each diagram
- Maintain consistent color coding (AWS=orange, Azure=blue)

Author: nickmoyni

playbook/diagrams/dev-deployment-flow.drawio

@@ -0,0 +1,78 @@
+# Development Environment - Deployment Flow
+
+```mermaid
+flowchart LR
+    %% Development Flow
+    Dev[👨‍💻 Developer] --> Push[📤 Git Push<br/>Feature Branch]
+    Push --> GHA[🔄 GitHub Actions<br/>Workflow Triggered]
+    GHA --> Validate[✅ Pre-commit Checks<br/>& Validation]
+    Validate --> Plan[📋 Terraform Plan<br/>Dev Environment]
+    Plan --> Security[🔒 Security Scan<br/>Checkov]
+    Security --> Deploy[🚀 Auto Deploy<br/>to Development]
+    Deploy --> Test[🧪 Automated Tests<br/>Unit & Integration]
+    Test --> Notify[📧 Notification<br/>to Developer]
+    Notify --> Dev
+    
+    %% Conditional paths
+    Validate -->|❌ Fails| Fix[🔧 Fix Issues]
+    Security -->|❌ Fails| Fix
+    Test -->|❌ Fails| Fix
+    Fix --> Dev
+    
+    %% Styling
+    classDef success fill:#28A745,stroke:#fff,stroke-width:2px,color:#fff
+    classDef process fill:#17A2B8,stroke:#fff,stroke-width:2px,color:#fff
+    classDef validation fill:#FFC107,stroke:#212529,stroke-width:2px,color:#212529
+    classDef failure fill:#DC3545,stroke:#fff,stroke-width:2px,color:#fff
+    classDef user fill:#6C757D,stroke:#fff,stroke-width:2px,color:#fff
+    
+    class Deploy,Test,Notify success
+    class GHA,Plan process
+    class Validate,Security validation
+    class Fix failure
+    class Dev user
+```
+
+## Development Deployment Characteristics
+
+### Trigger Conditions
+- **Event**: Push to any feature branch
+- **Frequency**: On every commit
+- **Approval**: None required
+
+### Workflow Steps
+
+1. **Code Push**: Developer pushes changes to feature branch
+2. **Workflow Trigger**: GitHub Actions automatically starts
+3. **Pre-commit Validation**: 
+   - Code formatting checks
+   - Terraform syntax validation
+   - Basic linting
+4. **Terraform Plan**: Generate infrastructure changes preview
+5. **Security Scan**: Checkov security analysis
+6. **Auto Deployment**: Deploy to development environment
+7. **Testing**: Run automated test suite
+8. **Notification**: Inform developer of results
+
+### Environment Characteristics
+
+| Aspect | Configuration |
+|--------|---------------|
+| **Infrastructure** | Minimal resources for cost efficiency |
+| **Monitoring** | Basic logging and metrics |
+| **Security** | Standard encryption, basic access controls |
+| **Availability** | Single AZ, no redundancy |
+| **Data Retention** | 7-30 days |
+
+### Success Criteria
+- ✅ All validation checks pass
+- ✅ Security scan shows no critical issues
+- ✅ Deployment completes successfully
+- ✅ Basic functionality tests pass
+- ✅ Developer receives success notification
+
+### Failure Handling
+- ❌ Immediate notification to developer
+- 🔧 Automatic rollback if deployment fails
+- 📝 Detailed error logs provided
+- 🔄 Easy re-trigger after fixes

playbook/diagrams/dev-deployment-flow.md

@@ -0,0 +1,129 @@
+# Kainos Studio - High-Level Architecture
+
+```mermaid
+graph TB
+    %% External Users
+    Users[👥 End Users]
+    
+    %% GitHub CI/CD
+    GitHub[🔄 GitHub Actions<br/>CI/CD Pipeline]
+    
+    %% AWS Infrastructure
+    subgraph AWS["☁️ AWS Infrastructure"]
+        direction TB
+        subgraph AWSCompute["Compute Layer"]
+            LambdaCore[⚡ Lambda<br/>Core Application]
+            LambdaUpload[⚡ Lambda<br/>Upload Handler]
+        end
+        
+        subgraph AWSStorage["Storage Layer"]
+            S3KFD[🗄️ S3<br/>KFD Files]
+            S3Forms[🗄️ S3<br/>Form Files]
+            DynamoDB[🗃️ DynamoDB<br/>Sessions]
+        end
+        
+        subgraph AWSMonitoring["Monitoring"]
+            CloudWatch[📊 CloudWatch<br/>Logs & Metrics]
+        end
+        
+        subgraph AWSSecurity["Security"]
+            KMS[🔐 KMS<br/>Encryption]
+            Secrets[🔑 Secrets Manager]
+        end
+    end
+    
+    %% Azure Infrastructure
+    subgraph Azure["☁️ Azure Infrastructure"]
+        direction TB
+        subgraph AzureCompute["Compute Layer"]
+            FunctionCore[⚡ Function App<br/>Core Application]
+            FunctionUpload[⚡ Function App<br/>Upload Handler]
+        end
+        
+        subgraph AzureStorage["Storage Layer"]
+            StorageKFD[🗄️ Storage Account<br/>KFD Files]
+            StorageForms[🗄️ Storage Account<br/>Form Files]
+            CosmosDB[🗃️ Cosmos DB<br/>Sessions]
+        end
+        
+        subgraph AzureMonitoring["Monitoring"]
+            AppInsights[📊 Application Insights<br/>Monitoring]
+        end
+        
+        subgraph AzureSecurity["Security"]
+            KeyVault[🔐 Key Vault<br/>Secrets & Keys]
+        end
+    end
+    
+    %% Connections
+    Users --> LambdaCore
+    Users --> FunctionCore
+    
+    GitHub --> AWS
+    GitHub --> Azure
+    
+    LambdaCore --> S3KFD
+    LambdaCore --> S3Forms
+    LambdaCore --> DynamoDB
+    LambdaUpload --> S3KFD
+    
+    FunctionCore --> StorageKFD
+    FunctionCore --> StorageForms
+    FunctionCore --> CosmosDB
+    FunctionUpload --> StorageKFD
+    
+    %% Monitoring connections
+    LambdaCore -.-> CloudWatch
+    LambdaUpload -.-> CloudWatch
+    FunctionCore -.-> AppInsights
+    FunctionUpload -.-> AppInsights
+    
+    %% Security connections
+    LambdaCore -.-> KMS
+    LambdaCore -.-> Secrets
+    FunctionCore -.-> KeyVault
+    
+    %% Styling
+    classDef aws fill:#FF9900,stroke:#232F3E,stroke-width:2px,color:#fff
+    classDef azure fill:#0078D4,stroke:#fff,stroke-width:2px,color:#fff
+    classDef app fill:#28A745,stroke:#fff,stroke-width:2px,color:#fff
+    classDef external fill:#6C757D,stroke:#fff,stroke-width:2px,color:#fff
+    
+    class AWS,AWSCompute,AWSStorage,AWSMonitoring,AWSSecurity,LambdaCore,LambdaUpload,S3KFD,S3Forms,DynamoDB,CloudWatch,KMS,Secrets aws
+    class Azure,AzureCompute,AzureStorage,AzureMonitoring,AzureSecurity,FunctionCore,FunctionUpload,StorageKFD,StorageForms,CosmosDB,AppInsights,KeyVault azure
+    class Users,GitHub external
+```
+
+## Architecture Overview
+
+### Multi-Cloud Design
+The Kainos Studio infrastructure supports deployment to both AWS and Azure, providing flexibility and avoiding vendor lock-in.
+
+### Core Components
+
+#### Compute Layer
+- **AWS**: Lambda functions for serverless execution
+- **Azure**: Function Apps for serverless execution
+- **Purpose**: Handle form processing, file uploads, and user interactions
+
+#### Storage Layer
+- **KFD Files**: Store Kainos Form Definition files
+- **Form Files**: Store user-submitted form data and attachments
+- **Sessions**: Maintain user session state and form progress
+
+#### Security Layer
+- **Encryption**: All data encrypted at rest and in transit
+- **Secrets Management**: Secure storage of application secrets and keys
+- **Access Control**: Least-privilege access patterns
+
+#### Monitoring Layer
+- **AWS**: CloudWatch for logs, metrics, and alarms
+- **Azure**: Application Insights for comprehensive monitoring
+- **Purpose**: Performance monitoring, error tracking, and operational insights
+
+### Data Flow
+1. Users interact with the application through serverless functions
+2. Functions process requests and store data in appropriate storage services
+3. Upload handlers manage file processing and storage
+4. All activities are monitored and logged for operational visibility
+5. CI/CD pipeline manages deployments across environments