Update README.md

README.md

@@ -2,7 +2,7 @@
 # AI Tutor Project
 
 
-A personalized AI learning assistant that **helps** to accelerate individual learning.
+"A personalized AI learning assistant that designs your learning plan with you, then tutors you through it."
 ---
 
 **Table of Contents**
@@ -14,8 +14,7 @@ A personalized AI learning assistant that **helps** to accelerate individual lea
     *   [Core Components](#core-components)
     *   [Effective Use Cases & Tips](#effective-use-cases--tips)
 *   [Future Improvements](#future-improvements)
-*   [Contributing](#contributing)
-*   [License](#license)
+
 
 ---
 
@@ -39,14 +38,19 @@ Traditional Large Language Models (LLMs) are incredibly knowledgeable but can so
 *   Designed for topics requiring deep thinking and understanding.
 
 ## How It Works (The Gist)
+The AI Tutor guides you from a broad idea to a focused learning session in four simple steps:
+
+1.  **Plan Your Lessons**
+    Start by chatting with the AI to define your learning goals. It can even process documents you provide (like PDFs or articles) to understand the context of what you want to master.
+
+2.  **Refine Your Roadmap**
+    The system then drafts a structured syllabus tailored to your conversation. You have full control to review, modify, and finalize this plan until it perfectly matches your needs.
 
-The AI Tutor operates through a workflow involving several key steps:
-1.  **Conversation Manager:** Talks with you to understand *what* you want to learn and *why* you want to learn.It **takes** summaries of resources you **provide** and **negotiates** the syllabus with you.You **can** modify it after the syllabus **is generated**.
-2.  **Syllabus Generator:** Based on your conversation and resources, it creates a structured learning plan.
-3.  **Persona Prompt Generator:** Helps define the "personality" and teaching style of the Explainer Agent. You guide this by describing how you want to be taught. This is the single most important step.
-4.  **Explainer Agent:** This is the AI that actually teaches you, following the generated syllabus and adopting the defined persona.
+3.  **Choose Your Teacher**
+    Once your plan is locked in, you describe your ideal teaching style. Want a demanding professor who uses the Socratic method? A friendly peer who explains with analogies? You define the persona.
 
-You can start a new chat to redefine the syllabus or persona if needed.
+4.  **Start Learning**
+    A custom AI tutor comes to life, ready to teach you based on *your* syllabus and in *your* preferred style, complete with proper formatting for code and math.
 
 
 ## A Deeper Dive: How AI Tutor Works
@@ -61,11 +65,14 @@ This project tackles these issues through a structured workflow:
 ### Core Components
 
 1.  **Conversation Manager (`Convo Manager`)**
+
+    *   **Key Responsibility:** Manages the initial dialogue to define user goals and control the workflow
     *   **Role:** Interacts with the user to understand their learning goals: *what* they want to learn, *why* (optional), and how (teaching style preferences. The "how" is **further refined** by the Persona Prompt Generator).
     *   **Resource Handling:** If resources are provided, it generates an initial summary.
     *   **Control Flow:** Manages the conversation flow, asking clarifying questions (temperature can be adjusted to reduce chattiness) and producing tags  (e.g., generate , modify , finalize , persona) to trigger subsequent agents like the Syllabus Generator and Persona Generator.
 
-2.  **Syllabus Generator**
+3.  **Syllabus Generator**
+    *   **Key Responsibility:** Generates a structured learning plan from the user's goals and provided resources.
     *   **Input:** User's learning objectives (from Convo Manager) and any provided resources.
     *   **Process:**
         *   **No Resources:** Uses a specific prompt to generate a syllabus from scratch.
@@ -73,7 +80,8 @@ This project tackles these issues through a structured workflow:
         *   *(Note: Performance with heavy resources can be enhanced with more powerful models or paid tiers by tweaking code in orchestrator & Dynamic Resource Generation.)*
     *   **Output:** A structured syllabus, which the user can then ask to modify.
 
-3.  **Persona Prompt Generator**
+5.  **Persona Prompt Generator**
+    *   **Key Responsibility:** Crafts the detailed system prompt that defines the AI tutor's personality and teaching methodology.
     *   **Trigger:** Activates after the syllabus is finalized.
     *   **Goal:** Defines the teaching style and "personality" of the Explainer Agent. This is a critical step for an effective learning experience.
     *   **User Input:** The user describes how they want to be taught.
@@ -82,7 +90,8 @@ This project tackles these issues through a structured workflow:
     *   **Output:** A system prompt for the Explainer Agent, generated by `PersonaPromptBodyPredictSignature` based on chat history and the user's persona description.
     *   *(Note: A good persona prompt is key. A generic one often leads to a subpar learning experience.)*
 
-4.  **Explainer Agent**
+7.  **Explainer Agent**
+    *   **Key Responsibility:** Acts as the final AI tutor, executing the teaching session based on the finalized syllabus and persona.
     *   **Input:** The system prompt (syllabus + persona) generated previously.
     *   **Role:** Greets the user and begins teaching according to the syllabus and defined persona.
     *   **Features:** Renders code and mathematical formulas correctly.
@@ -124,4 +133,5 @@ app_file: app.py
 pinned: false
 license: mit
 short_description: Your personal learning plan architect.
+---