Codex-generated pull request

docs/projects/creating-first-project.mdx

@@ -70,3 +70,15 @@ Open deployment **Settings** and configure:
 - [x] Route configured to active deployment
 - [x] Analytics and observability validated
 - [x] Guardrails applied
+
+
+## Creation-to-Readiness Flow
+
+```mermaid
+flowchart LR
+    A[Create Project] --> B[Set Metadata]
+    B --> C[Invite Team]
+    C --> D[Open Deployments]
+    D --> E[Create Endpoint]
+    E --> F[Review Health & Settings]
+```

docs/projects/guides/deployment-settings-and-autoscaling.mdx

@@ -7,6 +7,18 @@ description: "Configure reliability, rate limits, and SLO-aware scaling inside a
 
 Project deployments support operational controls for reliability and cost efficiency.
 
+## Reliability and Scaling Flow
+
+```mermaid
+flowchart TD
+    A[Open Deployment Settings] --> B[Configure Rate Limits]
+    B --> C[Set Retry/Fallback]
+    C --> D[Enable Autoscaling]
+    D --> E[Monitor Scale Events]
+    E --> F[Iterate Using SLOs]
+```
+
+
 ## Configure Rate Limiting
 
 In deployment **Settings**:

docs/projects/guides/managing-project-members.mdx

@@ -7,6 +7,17 @@ description: "Invite collaborators and manage project-level permissions"
 
 Project member management lets you control who can view and operate project resources.
 
+## Member Management Flow
+
+```mermaid
+flowchart TD
+    A[Open Project] --> B[Invite Member]
+    B --> C[Assign View/Manage]
+    C --> D[Review Effective Access]
+    D --> E[Update or Remove if Needed]
+```
+
+
 ## Invite Members
 
 1. Open the target project.

docs/projects/introduction.mdx

@@ -9,6 +9,16 @@ The **Projects** module is the operational home for delivery teams in Bud AI Fou
 
 Use projects to define ownership boundaries, manage access, and keep production operations auditable.
 
+```mermaid
+flowchart LR
+    A[Project] --> B[Deployments]
+    A --> C[Agents]
+    A --> D[Routes]
+    A --> E[Analytics]
+    A --> F[Observability]
+    A --> G[Guardrails]
+```
+
 ## Why Projects Matter
 
 **Unified AI Delivery Workspace**

docs/projects/project-concepts.mdx

@@ -7,6 +7,20 @@ description: "Understand project structure, permissions, and operational boundar
 
 A project is the primary boundary for organizing AI assets and operations in Bud AI Foundry. Most day-to-day activities—deployment lifecycle, routing, analytics, and safety controls—are scoped to a project.
 
+## Project Scope Diagram
+
+```mermaid
+flowchart TB
+    P[Project Boundary] --> PM[Metadata]
+    P --> RBAC[Permissions]
+    P --> TABS[Operational Tabs]
+    TABS --> DEP[Deployments]
+    TABS --> ROU[Routes]
+    TABS --> OBS[Observability]
+    TABS --> GUA[Guardrails]
+```
+
+
 ## Core Concepts
 
 ### 1. Project Metadata

docs/projects/quickstart.mdx

@@ -5,6 +5,18 @@ description: "Create your first project and prepare it for deployment workflows"
 
 This quick start shows how to create a project, add collaborators, and validate core tabs so your team can start deploying models safely.
 
+## Quickstart Flow
+
+```mermaid
+flowchart TD
+    A[Open Projects] --> B[Create Project]
+    B --> C[Add Members]
+    C --> D[Validate Tabs]
+    D --> E[Create First Deployment]
+    E --> F[Configure Reliability]
+```
+
+
 ## Step 1: Open Projects
 
 1. Sign in to Bud AI Foundry.

docs/projects/reference/project-tabs-reference.mdx

@@ -7,6 +7,20 @@ description: "Reference for tabs and key actions available in project details"
 
 The project detail page is organized into tabbed operational areas.
 
+## Tab Navigation Map
+
+```mermaid
+flowchart LR
+    P[Project Details] --> D[Deployments]
+    P --> A[Agents]
+    P --> R[Routes]
+    P --> AN[Analytics]
+    P --> C[Clusters]
+    P --> O[Observability]
+    P --> G[Guardrails]
+```
+
+
 ## Tabs
 
 ### Deployments

docs/projects/troubleshooting.mdx

@@ -3,6 +3,18 @@ title: "Troubleshooting"
 description: "Common issues when creating and managing projects"
 ---
 
+## Troubleshooting Decision Flow
+
+```mermaid
+flowchart TD
+    A[Project Issue] --> B{Issue Type}
+    B -->|Access| C[Verify RBAC / Role]
+    B -->|Creation/Update| D[Check validation + uniqueness]
+    B -->|Members| E[Verify identity and invite state]
+    B -->|Deletion| F[Remove active deployments]
+    B -->|Runtime Tabs| G[Check traffic, filters, health]
+```
+
 ## Project Access Issues
 
 ### Can't see Projects in navigation