Add Ascii art and update agent

README.md

@@ -20,7 +20,34 @@ This project implements a multi-agent workflow using **LangGraph** to process, t
 
 ## Workflow Flow & Agent Classes
 
-The core analysis logic is driven by a LangGraph StateGraph defined in `src/workflow.py`. The state moves sequentially between several agent classes located in the `src/agents/` directory:
+The core analysis logic is driven by a LangGraph StateGraph defined in `src/workflow.py`. The state moves sequentially between several agent classes located in the `src/agents/` directory.
+
+### Workflow Architecture
+```text
+                 [ IntakeAgent ]
+                        |
+                        v
+                   [ Router ]
+                  /          \
+      (If Audio) /            \ (If Text)
+                v              \
+    [ TranscriptionAgent ]      |
+                \              /
+                 \            /
+                  v          v
+              [ ModerationAgent ]
+                        |
+                        v
+            [ SummarizationAgent ]
+                        |
+                        v
+            [ QualityScoringAgent ]
+                        |
+                        v
+                      (END)
+```
+
+### Agent Classes
 
 1. **`IntakeAgent` (`src/agents/intake_agent.py`)**
    - *Entry Point*.
@@ -36,13 +63,17 @@ The core analysis logic is driven by a LangGraph StateGraph defined in `src/work
    - Utilizes `openai-whisper` to convert audio files into text.
    - Also scrubs the resulting transcript of profanity before passing it down the pipeline.
 
-4. **`SummarizationAgent` (`src/agents/summarization_agent.py`)**
-   - Takes the clean text from either the `IntakeAgent` (if CSV) or the `TranscriptionAgent` (if Audio).
+4. **`ModerationAgent` (`src/agents/ModerationAgent.py`)**
+   - Receives text either directly from the `Router` (if text upload) or from the `TranscriptionAgent` (if audio upload).
+   - Identifies any obscene words or profanity using an LLM and replaces them entirely with a `***` mask to safely prepare the text for downstream analysis.
+
+5. **`SummarizationAgent` (`src/agents/summarization_agent.py`)**
+   - Takes the redacted text from the `ModerationAgent`.
    - Generates a concise summary and extracts key points using OpenAI (`gpt-3.5-turbo`).
 
-5. **`QualityScoringAgent` (`src/agents/quality_scoring_agent.py`)**
+6. **`QualityScoringAgent` (`src/agents/quality_scoring_agent.py`)**
    - Takes the clean text and evaluates it against a predefined rubric.
-   - Scores the transcript based on Tone, Professionalism, and Structured Resolution.
+   - Scores the transcript based on Tone, Professionalism, and Structured Resolution. Automatically applies a 3-point penalty to each score and logs a count of policy violations if the `ModerationAgent` detected and masked any profanity (`***`).
 
 ## Prerequisites