Claude/add mermaid diagrams zkvj2

CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog — Access to Education
 
+```mermaid
+timeline
+    title Access to Education Version History
+    2026-03-28 : v1.0.0 Initial Release
+               : 11 files, core domains
+    2026-03-28 : v2.0.0 12 New Domains
+               : Early childhood, athletics, health, CTE, rural
+    2026-03-28 : v3.0.0 9 New Domains
+               : Counseling, governance, crisis, PD, culture
+    2026-03-28 : v4.0.0 AI in Education
+               : DESE AI guidance, federal landscape
+    2026-03-28 : v5.0.0 OS Refactor
+               : Role recipes, guardrails, quality checklist
+    2026-03-28 : v6.0.0 Behavioral Intelligence
+               : Decision trees, Spanish support, document generation
+    2026-03-28 : v7.0.0 Pod Architecture
+               : 22 commands, 50+ templates, calculators
+```
+
 ## v7.0.0 (2026-03-28) — Pod Architecture + Commands + Templates
 ### Added
 - Pod-based directory structure (roles/, operations/, compliance/, programs/)

GETTING_STARTED.md

@@ -2,6 +2,19 @@
 
 This guide walks you through setting up **Access to Education** as your personal Missouri K-12 assistant. No coding required.
 
+```mermaid
+flowchart LR
+    A[Choose Setup Method] --> B[Option A: Claude Code]
+    A --> C[Option B: Claude Project]
+    A --> D[Option C: Share with Team]
+    B --> B1[Install Claude Code] --> B2[Clone Repo] --> B3[Run 'claude']
+    C --> C1[Create Account] --> C2[New Project] --> C3[Paste SKILL.md] --> C4[Upload References]
+    D --> D1[Set Up Project] --> D2[Share Link]
+    B3 --> E[Ask Questions / Use Commands]
+    C4 --> E
+    D2 --> E
+```
+
 ---
 
 ## Option A: Claude Code (fastest)

README.md

@@ -11,6 +11,29 @@ Answers questions, generates documents, and walks through complex processes for
 
 ---
 
+```mermaid
+graph TD
+    A[User Query] --> B{Role Detection}
+    B --> C[Student]
+    B --> D[Parent]
+    B --> E[Teacher]
+    B --> F[Specialist]
+    B --> G[Principal]
+    B --> H[Staff]
+    B --> I[District Admin]
+    C & D & E & F & G & H & I --> J{Quick Answer?}
+    J -->|Yes| K[Immediate Response]
+    J -->|No| L[Load Reference Files]
+    L --> M{Need a Document?}
+    M -->|Yes| N[templates/]
+    M -->|No| O{Need Calculation?}
+    O -->|Yes| P[scripts/calculators.md]
+    O -->|No| Q[Role-Adapted Answer]
+    N & P & Q --> R[Response with Citations]
+```
+
+---
+
 ## What It Does
 
 | Capability | Details |

SKILL.md

@@ -7,6 +7,34 @@ description: "Access to Education — Missouri K-12 education navigator for stud
 
 ## How This Skill Works
 
+```mermaid
+flowchart TD
+    S1["SS1: Detect Role"] --> S2{"SS2: Quick Answer?"}
+    S2 -->|Yes| QA[Deliver Fact + Citation]
+    S2 -->|No| S3["SS3: Apply Role Recipe"]
+    S3 --> S4{"SS4: Need Reference File?"}
+    S4 -->|Yes| RF[Load from references/]
+    S4 -->|No| S5{"SS5: Building a Document?"}
+    RF --> S5
+    S5 -->|Yes| TM[Load from templates/]
+    S5 -->|No| S6{"SS6: Sensitive Topic?"}
+    TM --> S6
+    S6 -->|Yes| GR[Apply Guardrails / Redirect]
+    S6 -->|No| S7{"SS7: Outside Education?"}
+    GR --> S9
+    S7 -->|Yes| HO[Hand Off]
+    S7 -->|No| S8{"SS8: Multi-Step Process?"}
+    S8 -->|Yes| DT[Walk Decision Tree]
+    S8 -->|No| S9["SS9: Anticipate Follow-Up"]
+    DT --> S9
+    S9 --> S10["SS10: Generate Document if Needed"]
+    S10 --> S11{"SS11: Spanish?"}
+    S11 -->|Yes| BI[Bilingual Response]
+    S11 -->|No| OUT[Deliver Response]
+    QA --> OUT
+    BI --> OUT
+```
+
 1. **Detect the role** — identify or ask who is asking (§1)
 2. **Check the quick-answer layer** — direct factual answer? give it immediately (§2)
 3. **Apply the role-adaptive response recipe** — shape the answer for the audience (§3)

commands/COMMANDS.md

@@ -2,6 +2,45 @@
 
 Slash commands provide quick entry points into common workflows. When a user types a command (or describes the intent), execute the corresponding workflow.
 
+```mermaid
+graph TD
+    CMD[22 Slash Commands]
+    CMD --> INTAKE[Intake & Navigation]
+    CMD --> PARENT[Parent Tools]
+    CMD --> COMPLIANCE[Compliance & Policy]
+    CMD --> SPECIALIST[Specialist Tools]
+    CMD --> CALC[Calculators & Lookup]
+    CMD --> OTHER[Scenarios & Language]
+
+    INTAKE --> s1["/start"]
+    INTAKE --> s2["/walkthrough"]
+    INTAKE --> s3["/evaluate"]
+
+    PARENT --> p1["/rights"]
+    PARENT --> p2["/letter"]
+    PARENT --> p3["/enroll"]
+
+    COMPLIANCE --> c1["/comply"]
+    COMPLIANCE --> c2["/policy"]
+    COMPLIANCE --> c3["/csip"]
+    COMPLIANCE --> c4["/safety-plan"]
+    COMPLIANCE --> c5["/crisis"]
+    COMPLIANCE --> c6["/threat"]
+
+    SPECIALIST --> sp1["/iep-check"]
+    SPECIALIST --> sp2["/graduation"]
+    SPECIALIST --> sp3["/compare"]
+
+    CALC --> ca1["/retire"]
+    CALC --> ca2["/a-plus"]
+    CALC --> ca3["/lookup"]
+    CALC --> ca4["/district"]
+    CALC --> ca5["/data"]
+
+    OTHER --> o1["/translate"]
+    OTHER --> o2["/pd"]
+```
+
 ## Command Index
 
 | Command | Description | Workflow |

examples/sample-outputs.md

@@ -2,6 +2,20 @@
 
 **These examples show the TARGET quality for responses. Match the structure, tone, and depth for the given role. All 7 roles plus the parent audience are represented.**
 
+```mermaid
+flowchart LR
+    A[User Input] --> B[Detect Role]
+    B --> C{Match Role Recipe}
+    C --> P[Parent: Rights-first + next steps]
+    C --> T[Teacher: Policy + practical application]
+    C --> SP[Specialist: Regulatory + timelines]
+    C --> ST[Student: Plain language + encouragement]
+    C --> PR[Principal: Actions + documentation]
+    C --> SF[Staff: Step-by-step + escalation]
+    C --> DA[Admin: Strategic options + financials]
+    P & T & SP & ST & PR & SF & DA --> O[Structured Output with Citations]
+```
+
 ---
 
 ## Example 1: Parent Asking About Suspension Rights

references/ai-in-education/INDEX.md

@@ -2,6 +2,27 @@
 
 **Read this file first when any AI-in-education question arises. Then load the specific sub-file.**
 
+```mermaid
+graph TD
+    INDEX["AI in Education<br/>INDEX<br/><i>Start Here</i>"]
+    TL["ai-teaching-learning.md<br/>Teaching Workflows, Tutoring,<br/>Platforms, Communication"]
+    PG["ai-policy-governance.md<br/>DESE Guidance, Privacy,<br/>Academic Integrity, Equity"]
+    LC["ai-literacy-career.md<br/>K-12 Curriculum, PD,<br/>Tools, Career Readiness"]
+
+    INDEX -->|"Instruction &<br/>Learning"| TL
+    INDEX -->|"Policy &<br/>Governance"| PG
+    INDEX -->|"Literacy &<br/>Careers"| LC
+
+    TL <-.->|"cross-reference"| PG
+    PG <-.->|"cross-reference"| LC
+    LC <-.->|"cross-reference"| TL
+
+    style INDEX fill:#4a90d9,color:#fff
+    style TL fill:#5cb85c,color:#fff
+    style PG fill:#d9534f,color:#fff
+    style LC fill:#f0ad4e,color:#fff
+```
+
 ## Sub-File Router
 
 | Sub-File | When to Read |

references/ai-in-education/ai-literacy-career.md

@@ -3,6 +3,42 @@
 <!-- Canonical source for: AI literacy K-12 curriculum, AI PD for educators, AI tools inventory, AI assessment design, AI and SEL, AI career readiness, parent communication, emerging applications -->
 <!-- Last content review: 2026-03 -->
 
+```mermaid
+graph LR
+    subgraph "AI Literacy K-12 Progression"
+        K2["K-2<br/>AI Awareness"]
+        E35["3-5<br/>AI Understanding"]
+        M68["6-8<br/>AI Application"]
+        H912["9-12<br/>AI Fluency"]
+        K2 --> E35 --> M68 --> H912
+    end
+
+    subgraph "Educator Pipeline"
+        PD["Professional<br/>Development"]
+        TOOLS["AI Tools<br/>Inventory"]
+        ASSESS["Assessment<br/>Redesign"]
+    end
+
+    subgraph "Outcomes"
+        SEL["AI + SEL"]
+        CAREER["Career<br/>Readiness"]
+        PARENT["Parent<br/>Communication"]
+    end
+
+    H912 --> CAREER
+    PD --> K2
+    TOOLS --> PD
+    ASSESS --> M68
+    H912 --> SEL
+    CAREER --> PARENT
+
+    style K2 fill:#a8d8ea,color:#000
+    style E35 fill:#7ec8e3,color:#000
+    style M68 fill:#4a90d9,color:#fff
+    style H912 fill:#2c5f8a,color:#fff
+    style CAREER fill:#f0ad4e,color:#000
+```
+
 ## Table of Contents
 1. AI Literacy Curriculum (K-12)
 2. AI Professional Development for Educators

references/ai-in-education/ai-policy-governance.md

@@ -3,6 +3,46 @@
 <!-- Canonical source for: DESE AI guidance, federal AI landscape, district AI policy development, academic integrity, AI data privacy, AI equity, responsible AI framework, AI governance -->
 <!-- Last content review: 2026-03 -->
 
+```mermaid
+graph TD
+    FED["Federal Landscape<br/>DOE, Executive Orders, DOL"]
+    DESE["Missouri DESE<br/>AI Guidance v1.0"]
+    MSBA["MSBA Model Policies"]
+
+    FED --> DESE
+    DESE --> MSBA
+    DESE --> DIST
+
+    subgraph "District Policy Development"
+        DIST["District AI Task Force"]
+        DIST --> POLICY["Draft AI Policy"]
+        POLICY --> BOARD["Board Adoption"]
+        BOARD --> IMPL["Implement & Train"]
+        IMPL --> REVIEW["Annual Review"]
+        REVIEW --> POLICY
+    end
+
+    subgraph "Policy Domains"
+        INTEGRITY["Academic<br/>Integrity"]
+        PRIVACY["Data Privacy<br/>FERPA / COPPA"]
+        EQUITY["Equity &<br/>Access"]
+        RESPONSIBLE["Responsible<br/>AI Framework"]
+        SB68["SB 68<br/>Device Ban"]
+    end
+
+    MSBA --> DIST
+    POLICY --> INTEGRITY
+    POLICY --> PRIVACY
+    POLICY --> EQUITY
+    POLICY --> RESPONSIBLE
+    POLICY --> SB68
+
+    style DESE fill:#4a90d9,color:#fff
+    style FED fill:#6c757d,color:#fff
+    style BOARD fill:#5cb85c,color:#fff
+    style PRIVACY fill:#d9534f,color:#fff
+```
+
 ## Table of Contents
 1. Missouri DESE AI Guidance
 2. Federal AI in Education Landscape

references/ai-in-education/ai-teaching-learning.md

@@ -3,6 +3,43 @@
 <!-- Canonical source for: AI-enhanced teaching workflows, prompt engineering for educators, AI tutoring, adaptive learning, student-facing AI by grade band, AI for special populations, AI for communication/administration -->
 <!-- Last content review: 2026-03 -->
 
+```mermaid
+flowchart LR
+    subgraph TEACH["Teacher Side"]
+        direction TB
+        PROMPT["Prompt Engineering<br/>(Five S Model)"]
+        WORKFLOW["AI-Enhanced<br/>Workflows"]
+        PROMPT --> WORKFLOW
+        WORKFLOW --> LESSON["Lesson Planning &<br/>Differentiation"]
+        WORKFLOW --> ASSESS["Assessment &<br/>Feedback"]
+        WORKFLOW --> COMM["Communication &<br/>Administration"]
+    end
+
+    subgraph LEARN["Student Side"]
+        direction TB
+        TUTOR["AI Tutoring &<br/>Adaptive Platforms"]
+        REINFORCE["Reinforcement<br/>(Spaced Practice,<br/>Retrieval, Feedback)"]
+        GRADE["Grade-Band<br/>Appropriate Use<br/>K-2 / 3-5 / 6-8 / 9-12"]
+        TUTOR --> REINFORCE
+        GRADE --> TUTOR
+    end
+
+    subgraph SPECIAL["Special Populations"]
+        direction TB
+        SPED["Special Education<br/>& Assistive Tech"]
+        ELL["English Language<br/>Learners"]
+        GIFTED["Gifted<br/>Education"]
+    end
+
+    TEACH -->|"AI generates,<br/>teacher reviews"| LEARN
+    LEARN --> SPECIAL
+    COMM --> DATA["Data-Driven<br/>Decisions"]
+
+    style TEACH fill:#4a90d9,color:#fff
+    style LEARN fill:#5cb85c,color:#fff
+    style SPECIAL fill:#f0ad4e,color:#000
+```
+
 ## Table of Contents
 1. AI-Enhanced Teaching Workflows
 2. Prompt Engineering for Educators

references/compliance/compliance-calendar.md

@@ -14,6 +14,43 @@
 11. OCR / Civil Rights Self-Assessment
 12. Audit Preparation Guide
 
+```mermaid
+gantt
+    title Missouri K-12 Annual Compliance Calendar — Key Deadlines
+    dateFormat YYYY-MM-DD
+    axisFormat %b
+
+    section Fiscal & Budget
+    New fiscal year / Budget adopted           :milestone, 2025-07-01, 0d
+    Budget development begins                  :2025-01-15, 30d
+    ASBR preparation                           :2025-06-15, 75d
+
+    section DESE Reporting
+    MOSIS Fall (October count)                 :milestone, 2025-10-15, 0d
+    Core Data fall submission                  :2025-10-15, 30d
+    MOSIS End-of-Year submission               :2025-06-01, 45d
+    Core Data EOY submission                   :2025-06-15, 60d
+
+    section Assessments
+    WIDA ACCESS for ELLs                       :2025-01-10, 60d
+    MAP / EOC testing window                   :2025-03-01, 75d
+    ACT statewide (juniors)                    :milestone, 2025-04-15, 0d
+
+    section Personnel
+    April 15 non-renewal deadline              :milestone, 2025-04-15, 0d
+    Background checks (new hires)              :2025-07-01, 30d
+    MEES evaluations                           :2025-08-15, 270d
+
+    section Board & Elections
+    Board election filing opens                :milestone, 2025-12-15, 0d
+    School board elections (1st Tue Apr)        :milestone, 2025-04-01, 0d
+
+    section Safety & Training
+    Mandated training (start of year)          :2025-08-01, 21d
+    Fire drills (monthly)                      :2025-09-01, 270d
+    Annual safety plan review                  :2025-07-01, 30d
+```
+
 ---
 
 ## 1. Annual Compliance Calendar (Month-by-Month)