docs: clean up diagrams README - remove Draw.io references

- Remove all Draw.io instructions and links
- Remove PNG export mentions
- Remove editing tool instructions
- Focus on Mermaid diagrams that render natively in GitHub
- Simplify updating procedures

Author: nickmoyni

playbook/diagrams/README.md

@@ -1,41 +1,39 @@
 # Infrastructure Diagrams
 
-This folder contains Draw.io diagrams for the Kainos Studio infrastructure architecture.
+This folder contains high-level architecture diagrams for the Kainos Studio infrastructure using Mermaid syntax for better visibility and version control.
 
 ## 📊 Available Diagrams
 
-### End-to-End Architecture
-- **[kainos-studio-architecture.drawio](./kainos-studio-architecture.drawio)** - Complete system architecture
-- **[kainos-studio-architecture.png](./kainos-studio-architecture.png)** - PNG export of architecture
+### High-Level Architecture
+- **[kainos-studio-architecture.md](./kainos-studio-architecture.md)** - Complete system architecture overview
 
-### Environment Flow Diagrams
-- **[dev-deployment-flow.drawio](./dev-deployment-flow.drawio)** - Development environment deployment flow
-- **[staging-deployment-flow.drawio](./staging-deployment-flow.drawio)** - Staging environment deployment flow
-- **[prod-deployment-flow.drawio](./prod-deployment-flow.drawio)** - Production environment deployment flow
+### Deployment Flow Diagrams
+- **[dev-deployment-flow.md](./dev-deployment-flow.md)** - Development environment deployment flow
+- **[staging-deployment-flow.md](./staging-deployment-flow.md)** - Staging environment deployment flow
+- **[prod-deployment-flow.md](./prod-deployment-flow.md)** - Production environment deployment flow
 
-## 🎨 How to Edit Diagrams
+## 🎨 Viewing Diagrams
 
-1. **Online**: Visit [draw.io](https://app.diagrams.net/) and open the `.drawio` files
-2. **VS Code**: Install the Draw.io Integration extension
-3. **Desktop**: Download Draw.io desktop application
+All Mermaid diagrams render directly in GitHub for easy viewing and collaboration.
 
 ## 📋 Diagram Standards
 
-- Use AWS/Azure official icons from the shape libraries
+- Use consistent color coding:
+  - Orange (#FF9900): AWS services
+  - Blue (#0078D4): Azure services
+  - Green (#28A745): Application components
+  - Red (#DC3545): Security boundaries
+  - Gray (#6C757D): External services
+
 - Include environment labels (dev/staging/prod)
 - Show data flow directions with arrows
-- Include security boundaries and zones
-- Use consistent color coding:
-  - Orange: AWS services
-  - Blue: Azure services
-  - Green: Application components
-  - Red: Security boundaries
-  - Gray: External services
+- Keep diagrams high-level and focused
+- Use meaningful component names
 
 ## 🔄 Updating Diagrams
 
 When infrastructure changes:
-1. Update the relevant `.drawio` file
-2. Export as PNG for easy viewing
-3. Commit both files to version control
+1. Update the relevant `.md` file with Mermaid syntax
+2. Test rendering in GitHub
+3. Commit changes to version control
 4. Update this README if new diagrams are added