# Product
Name: Clarity AI Writing Assistant
Website: https://goclarityai.com

# Description
Clarity AI is an AI-powered educational platform designed to improve literacy standards for Key Stage 2 (KS2) students. It features a dual-interface system: a gamified learning environment for students to practice creative writing, reading comprehension, and vocabulary, and a comprehensive dashboard for teachers to automate grading and track progress.

# Audience
- **Students**: Key Stage 2 (Ages 9-11)
- **Teachers**: Primary school educators
- **Parents**: Home educators and mentors

# Key Features

## Student Experience
- **Vocabulary Studio**:
  - **Flashcards**: Interactive cards with definitions, examples, images, and audio pronunciation.
  - **Practice Tests**: Spelling, Meaning, and Sentence usage tests.
  - **Challenge Mode**: Self-initiated vocabulary quizzes.
- **Literacy & SPaG (Sentence Studio)**:
  - **Skill Practice**: Targeted exercises for Connectives, Openers, Punctuation, Grammar, and Figurative Language.
  - **Sentence Gym**: AI-powered analysis of user-inputted text with specific error correction and explanations.
- **Reading Club**:
  - **Comprehension Tests**: Timed passage reading with Q&A (Multiple choice, Short answer).
  - **Book Reviews**: Structured forms for reviewing books and analyzing characters.
- **Creative Writing Module**:
  - **Story Map**: Visual planning tool with drag-and-drop nodes.
  - **Story Builder**: Step-by-step drafting (Opening, Build-up, Climax, Resolution).
  - **Magic Menu**: Quick insertion of literary devices (SHAMPOO), openers, and vocabulary.
  - **AI Brainstorming**: "Sage" AI Tutor for idea brainstorming & generation.
  - **Submission Types**: Text entry, File upload (OCR capable), Camera capture.
- **Gamification & Engagement**:
  - **Currency System**: Earning "Clarity Coins" and XP.
  - **Writer's Den**: Customizable virtual room (furniture placement).
  - **Shop**: Purchasing cosmetic items with coins.
- **AI Tutoring**:
  - **"Sage" Tutor**: Real-time chat (Text & Voice) help & idea generation.
  - **Weekly Growth Map**: AI-driven visualization of skills (Structure, Vocabulary, Grammar, Punctuation) with historical trends and automated strategy suggestions.
  - **Personalised Suggestions**: AI-driven recommendations based on weak skill areas.

# Design & UX
Clarity AI uses a modern, high-contrast, and lively design system tailored for education. 
- **Typography**: Uses 'Outfit' for headings (bold/playful) and 'Inter' for UI (legibility).
- **Interactions**: Leveraging 'motion/react' for fluid, bouncy transitions that maintain high engagement levels.
- **Tone**: Warm, encouraging, and patient.

## Teacher Experience
- **Class Management**:
  - **Roster**: View, filter, and manage students.
  - **Grouping**: Create custom student groups for targeted assignments.
  - **Invites**: Email invitation system.
- **Content Creation & Assignment**:
  - **AI Generator**: Generate writing prompts, comprehension passages, and SPaG quizzes based on topic/age.
  - **Templates**: Create, save, and reuse assignment templates.
  - **Library Management**: Manage class book lists and vocabulary hierarchies.
  - **Distribution**: Assign tasks to specific students, groups, or the whole class.
- **Assessment & Feedback**:
  - **Rubric Builder**: Default Rubrics and ability to Customise Rubrics for an assignment.
  - **AI Pre-Grading**: Auto-generation of Annotated feedback and scores based on the assigned rubric, summary feedback, and SPaG error detection.
  - **Manual Review**: Annotating text, adjusting scores, and finalising feedback reports.
- **Analytics & Insights**:
  - **Class Insights**: AI analysis of aggregate class performance (Strengths/Weaknesses).
  - **Student Insights**: Two levels of Spider performance view across 5 skills.
  - **Lesson Planning**: AI generation of 15-minute intervention plans based on performance data.
  - **Activity Reporting**: Track completion rates and engagement.

## Parent Experience
- **Child Connection**: Linking parent accounts to student accounts.
- **Progress Monitoring**: Viewing charts of performance over time.
- **Feedback View**: Accessing detailed reports of completed assignments.

## AI Engine Capabilities (Backend/Logic)
- **Text Generation**: Creating prompts, stories, and passages (Gemini Flash).
- **Evaluation**: Grading against rubrics, detecting SPaG errors (Gemini Pro).
- **Image Generation**: Creating visual aids for vocabulary and assignments (Imagen).
- **Video Generation**: Creating narrative clips for Clarity Chronicles (Veo).
- **Voice/Audio**: Text-to-Speech and Speech-to-Text for the "Sage" tutor.

# Data Usage
Clarity AI uses Google Gemini models (Pro and Flash) for reasoning, grading, and content generation. Student submissions are processed to provide feedback and generate analytics. All data is stored and managed securely via Firebase.

# Contact
Email: saurabh.bansal@goclarityai.com