PrepAiro IB
AI Agent Directory

Platform Documentation

# PrepAiro
> AI-powered study platform built exclusively for IB students — MYP 1 through DP 2. The first platform to serve the IB MYP market natively with school-specific, year-specific learning paths.

## About
PrepAiro is built by Airo. It targets IB MYP students (ages 11-16) and IB DP students (ages 16-18) across 1,081+ MYP schools in 110+ countries. The core insight: students know concepts but struggle to write structured, exam-ready answers. PrepAiro fills that gap with AI tutoring that never gives direct answers, criterion-aligned feedback, and curriculum-mapped content.

- Company: Airo
- Primary market: IB schools in India (60-80 MYP schools), expanding globally
- Business model: Parent buys, student uses (Rs 500-800/month)
- Brand voice: Witty, warm, never cringe — like a smart friend, not a teacher
- Positioning: Not competing with the tutor. Fills the 90% of study time the tutor isn't there for.

## Core Features

### Homework Help (Live)
Two AI-powered tutoring modes. Students interact via tappable chips — never need to type full sentences.

**Help Mode (Socratic Tutoring):**
AI guides students to the answer without giving it directly. Uses a 5-level escalation system:
1. Orient — Restate the problem, identify what's being asked
2. Hint — Directional nudge without revealing the method
3. Scaffold — Break into sub-steps, guide through the first step
4. Partial Walkthrough — Show method on a similar problem
5. Full Walkthrough — Complete solution with full explanation

The AI reads student confidence and adapts tone in real-time. Celebrates small wins. Never repeats the same approach — tries a new angle if the student is stuck.

**Analyse Mode (Examiner Review):**
For reviewing completed work. AI reviews one sub-question at a time, stops at the first error, and explains the mistake directly — no Socratic method. References MYP criteria (A-D) and achievement levels naturally. Ends with a casual conversational overview, not a formal summary.

**Input methods:** Photo upload, document upload (PDF), typed/pasted text.

**Chat features:**
- SSE-streamed AI responses with real-time token rendering
- Dynamic response chips that update every AI turn (response, action, confidence, math chips)
- Math symbol keyboard with tap-to-insert (x, division, sqrt, pi, sigma, plus-minus, greater-equal, less-equal)
- Idle nudge system: first nudge at 60s, second at 90s, max 2 per session
- Resource cards surfaced inline when AI detects a relevant concept (Notes, Flashcard, or Question cards with View more CTA)
- Full-screen resource overlay with Minimise (return to chat) and Open in Learn controls

### Learn Section (Live)
School-specific and year-specific learning paths. Three resource types per subtopic:

**Notes:**
- AI-enhanced explanatory content following Teach, Check, Bridge rhythm
- Interactive key terms (tap for micro-definition bubble, no page navigation)
- Sticky horizontal section anchors for quick navigation
- Reading progress bar showing percentage read
- Floating AI Study Buddy button opening a half-sheet overlay with preloaded chips: Explain a term, Summarise this, Test me, I'm confused
- Post-completion screen with CTAs to Flashcards, Quizzes, next subtopic, or back to topic list

**Quizzes (bite-sized):**
- Each subtopic's question bank split into fixed quizzes of 5 questions each
- Standalone 2-3 minute sessions with step dots navigation
- Linear locked flow — no back navigation, no skipping ahead
- In-place answer reveal: correct highlights green, wrong highlights red, explanation card slides in with AI help button
- "no clue, show me" skip CTA — tracked separately as knowledge gap (distinct from wrong answer/misconception)
- Gen Z result screen with dynamic headline copy by accuracy tier
- Aura points earned per quiz with counting animation
- All quizzes unlocked from start (no sequential locking), completed quizzes replayable
- Report/flag system on every question card

**Cheatsheets:**
- Condensed reference material per subtopic for quick revision

**Content coverage:** 9 subjects, 71 parent topics, 376 subtopics total. Currently live with foundational MYP content for Biology, Chemistry, and Standard Mathematics. School-specific content being built starting with Oakridge International School, Bangalore.

### Streaks and XP (Live)
**Streaks:** Consecutive calendar days with at least one qualifying activity (completing notes, finishing a quiz, or having a chatbot exchange). Visible as fire emoji + count in top navbar on every screen.
- Milestone celebrations at 7, 14, 30, 60, 100, and 365 days with escalating animations
- Silent grace days in backend (max 3, earned at streaks 3/10/20) — students never see them
- Filler screen shown only on first qualifying activity of each day

**XP (Aura Points):** Earned per activity. Counting-up animation on quiz result screens with sound and haptics.

### DP Assessment Evaluator (In Progress)
AI-powered evaluation tool for three major DP written assessments:
- Internal Assessments (IAs) — per subject, worth 20-25% of each subject grade
- Extended Essays (EEs) — 4,000 words, independent research
- TOK Essays — 1,600 words, responding to prescribed titles

Students upload a draft (PDF, photo, or pasted text), select assessment type, and receive:
- Criterion-by-criterion evaluation with predicted band scores
- Specific quotes from student's work with inline highlights
- Concrete improvement suggestions and band-up tips
- Overall predicted total score and band
- Priority action list ranked by impact
- Revision tracking across versions (v1, v2, v3 comparisons)

Phase 1 subjects: Physics, Chemistry, Biology, Math AA/AI IAs + EE + TOK Essay.

### IO Practice (Coming Next)
AI examiner for the Individual Oral — the 15-minute recorded oral assessment in Language A and Language B.
- Language A IO: 10 min student presentation connecting a literary/non-literary text to a global issue + 5 min examiner follow-up questions
- Language B IO: Visual stimulus presentation + follow-up discussion + general conversation, conducted entirely in the target language
- Voice-first with text fallback
- Criterion-aligned feedback with predicted scores
- Fluency analysis: pace, filler words, pauses, confidence
- Session recording with timestamp-synced feedback markers
- Phase 1 languages: English, French B, Spanish B, Hindi B

### PrepAiro Forum (Planned)
Anonymous, topic-structured Q&A community forum. AI answers first, community upvotes. School-level communities for peer learning. SEO-indexable content targeting MYP-specific searches.

### Challenge Duels (Planned)
Any student can challenge a friend to answer the same questions on a topic. Result is a shareable side-by-side comparison card.

## App Structure

### Navigation
- **Home Page:** Entry screen after login. Top navbar with streak count and XP/Aura points (visible on every screen). Airo chatbot banner. Entry points to Learn Section and Homework Help.
- **Sidebar:** Triggered by hamburger icon or left-edge swipe. Available everywhere. Contains: Homework Help (always top), enrolled subjects list, Add subject, Profile, Settings.
- **Learn flow:** Sidebar subject tap -> Topic List (collapsible units with subtopics) -> Subtopic Resource Screen (Notes/Quizzes/Cheatsheets cards) -> Resource View
- **Homework Help flow:** Home -> Homework Help -> Mode Selection (Analyse/Help) -> Input Screen -> Chat Session

### Back Navigation Rules
Back always returns one level up within the same resource type. Never jumps across resource types or sections unexpectedly.

## User Flows

### Signup and Onboarding
**Parent signup:**
1. Email + password -> Create Account
2. Enter student's school (autocomplete) + MYP year (MYP 3/4/5) or DP year (DP 1/2)
3. Invite student via email (or skip)
4. Parent lands on Parent Dashboard

**Student onboarding (via invite email):**
1. Tap CTA in invite email -> password-set page (mobile-responsive web)
2. Set password -> Continue
3. Subject selection (optional, multi-select chip grid pre-filtered by year)
4. Land on Homework Help section (default landing after onboarding)
5. One-time tooltip: "Start by uploading your homework or explore your subjects from the menu."

### Access Control
Access determined by verified email domain (OTP verification):
- Verified `@oakridge.in` email -> Full access (everything unlocked, no caps)
- Any other email -> Restricted access with daily limits:
  - Homework Help: 1 document upload/day (full chat session after upload)
  - EE/TOK Evaluation: 1 evaluation/day (DP students only)
  - Duels: 2/day
  - Viral tools: Unlimited
  - Learning Path: Locked (0 access)

Restricted users see contextual restriction screens with waitlist and ambassador program CTAs.

### Pricing
| Tier  | Price           | Includes                                                              |
|-------|-----------------|-----------------------------------------------------------------------|
| Free  | Rs 0            | Limited quizzes (2 per subject), limited chatbot messages             |
| Pro   | Rs 500-800/month| Full Learn section, unlimited Homework Help, streaks, XP, Forum, Duels|

Parent pays. Student uses.

## IB Curriculum Coverage

### MYP Subjects (9 subjects, 376 subtopics)
| Subject                          | Parent Topics | Subtopics |
|----------------------------------|---------------|-----------|
| Biology                          | 9             | 43        |
| Chemistry                        | 10            | 39        |
| Physics                          | 8             | 31        |
| Standard Maths                   | 4             | 34        |
| Extended Maths                   | 4             | 32        |
| English Language and Literature  | 7             | 40        |
| History                          | 10            | 49        |
| Geography                        | 10            | 60        |
| Individuals and Societies        | 8             | 48        |

Sciences and Maths are Phase 1 (standardised across all IB schools). Humanities are Phase 2 (school-specific curriculum varies per school).

### MYP Assessment Structure
- 4 criteria per subject (A-D), scored 1-8
- Three assessment descriptor sets: Year 1, Year 3, Year 5
- MYP eAssessment: optional external on-screen exam for Year 5
- Personal Project: mandatory Year 5 capstone (evaluated on report and presentation, not the project itself)
- Community Project: Years 3-4

### DP Assessments Supported
- Internal Assessments (IAs): Subject-specific, 5 criteria, 20-24 marks total
- Extended Essay (EE): 4,000 words, 5 criteria, 34 marks total, bands A-E
- TOK Essay: 1,600 words, 3 criteria, 30 marks total, bands A-E
- Individual Oral (IO): 15 minutes, 4 criteria (Language A) or 3 criteria (Language B)

## Technical Architecture
- **Student app:** Flutter (mobile-first, iOS + Android)
- **AI engine:** Anthropic Claude API
- **Backend:** Node.js API, PostgreSQL
- **Real-time:** SSE streaming for AI chat responses and evaluation delivery
- **Design system:** Purple primary (#675BD8), Inter font, dark mode support, 375x812 base resolution

### API Structure
**Auth:** POST /auth/login, POST /auth/google, GET /auth/me
**Onboarding:** PUT /onboarding/profile, GET /onboarding/subjects, POST /onboarding/subjects
**Learn:** GET /learn/subjects, GET /learn/subjects/{id}/topics, GET /learn/subtopics/{id}/notes, GET /learn/subtopics/{id}/questions?difficulty=N, POST /learn/questions/{id}/answer, GET /learn/subtopics/{id}/progress
**Tutor (Homework Help):** POST /tutor/chat (SSE streaming), GET /tutor/nudge, GET /tutor/conversations, GET /tutor/conversations/{id}/history
**DP Evaluator:** POST /evaluator/upload, POST /evaluator/evaluate (SSE streaming), GET /evaluator/history, GET /evaluator/history/{id}, GET /evaluator/compare/{v1}/{v2}
**IO Practice:** POST /io-practice/session/start, POST /io-practice/session/audio, POST /io-practice/session/text, POST /io-practice/session/end, GET /io-practice/session/{id}/feedback (SSE), GET /io-practice/history
**Access Control:** POST /api/v1/waitlist/school, GET /api/v1/waitlist/school/count, POST /api/v1/ambassador/apply, GET /api/v1/access/limits
**Profile:** GET /profile, PUT /profile, POST /profile/avatar, PUT /profile/subjects

### SSE Event Types
| Event              | Context     | Action                                              |
|--------------------|-------------|-----------------------------------------------------|
| questions          | Tutor       | Show extracted question cards                       |
| mode               | Tutor       | Set analyze/help mode indicator                     |
| thinking           | Tutor       | Show animated thinking dots                         |
| token              | All chat    | Append to current AI message                        |
| chips              | All chat    | Render contextual chip bar below message            |
| done               | All chat    | Save conversation/evaluation, end stream            |
| error              | All chat    | Show error toast                                    |
| evaluation_start   | Evaluator   | Show assessment type header                         |
| criterion          | Evaluator   | Start new criterion evaluation block                |
| score              | Evaluator   | Display predicted band/score                        |
| quote              | Evaluator   | Highlight referenced text from upload               |
| overall            | Evaluator   | Display total predicted score and band              |
| phase_change       | IO Practice | Update phase indicator (Presentation/Discussion/Feedback) |
| examiner_question  | IO Practice | Display follow-up question                          |
| transcript         | IO Practice | Real-time speech transcription                      |
| fluency_stats      | IO Practice | Pace/filler/pause analysis                          |

## Sound and Haptics
- Reward over Punish: correct answer sound is 3x more satisfying than wrong answer feels bad
- All sounds under 1.5 seconds, most under 0.5 seconds
- Escalating pitch on consecutive correct answers in quizzes
- Strongest haptics reserved for streak milestones and perfect quiz scores
- Push notification uses same correct-answer chime (Pavlovian conditioning)
- Settings: Sound Effects ON/OFF, Haptic Feedback ON/OFF (both default ON)

## Social Layer (Planned)
13 social features across 3 phases. Core principles:
- Social is always opt-in, never mandatory
- Performance data is private — no public scores, no global rankings
- Solidarity over competition — IB is hard, we're in it together
- Every feature works with zero friends on Day 1

### IB Personality System (12 Archetypes)
Identity-first system assigned via 5-question quiz, recalculated monthly from in-app behavior. Archetypes: The Midnight Scientist, The Formula Whisperer, The Humanities Heart, The Strategic Slacker, The Overachiever Spiral, The Last Minute Legend, The Consistent Grinder, The Ghost Reviver, The Vibe Studier, The Study Group Anchor, The Question Hoarder, The Tab Collector.

Monthly personality card generated on 1st of each month for 12 recurring viral moments per year.

## Go-to-Market Strategy

### School-Exclusive Launch
Launching school-by-school for density over spread. Each school gets school-specific, year-specific learning paths.

**First school:** Oakridge International School, Bangalore
- Nord Anglia network (89 schools globally)
- 9 consecutive years beating global eAssessment average
- ~250-325 MYP students, Sarjapur Road IT corridor parent demographic
- Success here is a case study for pitching Nord Anglia India (5 campuses) then Nord Anglia Global

**Expansion sequence:** Oakridge Hyderabad -> other Bangalore MYP schools -> Mumbai (11 continuum schools) -> Delhi/NCR -> Nord Anglia India centrally -> other school groups

### Organic Distribution (No Paid Ads)
- Content seeding: High-quality MYP resources on Reddit (r/IBO), Discord, WhatsApp groups
- Student ambassador program: 1-2 students per school, free access, counts toward CAS Service hours
- Viral tools: Zero-signup web tools (IB Personality Quiz, How Cooked Am I, IB Roast Generator, Grade Predictor) designed for screenshot-sharing on Instagram and WhatsApp
- FOMO gating: Students from unsupported schools see restricted access with "Bring PrepAiro to your school" waitlist flow

### Target Addressable Market
- 39 IB continuum schools across 7 Indian metro cities
- 1,081 MYP schools globally across 110+ countries
- ~500K-800K MYP students estimated globally
- Revenue targets: $1-3.5M ARR Year 1, $5-12M ARR Year 3

## Competitive Landscape
No competitor serves the IB MYP market natively.

| Competitor    | Gap                                                            |
|---------------|----------------------------------------------------------------|
| ZuAI          | IB DP focus, no MYP features                                   |
| RevisionDojo  | IB DP question bank only                                       |
| EduBrain      | General AI tutoring, no IB alignment                           |
| Knowt         | Flashcards, no curriculum mapping                              |
| Photomath     | Math solver, no pedagogical method                             |
| Question AI   | Gives direct answers (no pedagogical refusal)                  |
| Gauth         | No criterion alignment                                         |
| StudyX        | No IB specificity                                              |
| ChatGPT       | No pedagogical guardrails, no criterion alignment, stateless   |

### Key Differentiators
1. Pedagogical refusal — Help Mode never gives direct answers (trust signal for parents)
2. MYP criterion alignment — feedback references Criterion A-D, achievement levels, command terms
3. Chip-driven interaction — students never type full sentences
4. School-specific learning paths — mapped to each school's exact curriculum
5. Continuous learning history — tracks patterns across sessions
6. Dual-audience design — parent buys with confidence, student uses with engagement

## Key Principles
1. PrepAiro is not competing with the tutor — it fills the 90% of study time the tutor isn't there for
2. Never give direct answers in Help Mode — pedagogical refusal is the core product identity
3. Students never type full sentences — chip-driven interaction is non-negotiable
4. Parent buys, student uses — dual-audience shapes everything
5. Density over spread — 10 engaged users at one school beats 1,000 scattered
6. Every feature works with zero friends on Day 1
7. Solidarity over competition — IB is hard, we're in it together
8. Reward over Punish — wrong answers are gentle, correct answers are celebratory

## Future Roadmap

### Phase 1 (Current)
- Viral social features for distribution (IB Personality Quiz, How Cooked Am I, IB Roast Generator)
- Pain point tools for retention (Answer Structuring Coach, Case Study Memoriser)
- Learn section with Sciences + Maths content
- School-specific learning paths starting with Oakridge Bangalore

### Phase 2
- School-specific curriculum for Humanities
- DP learning paths (DP 1 and DP 2)
- CAS Tracker and Portfolio
- Student Ambassador Dashboard
- Forum launch

### Phase 3
- AP market entry (25x larger than IB: ~10M exams/year)
- B2B school partnerships (ISP, Nord Anglia, Inspired, Cognita — combined 175-233 MYP schools)
- Parent app (separate from student app, Co-Pilot mode for MYP 1-2, Mission Control mode for MYP 3-5)

## Feature Backlog
63 features across 9 categories planned:
- 8 viral tools (zero-signup web)
- 10 daily games ("IB Games")
- 6 skill trainers ("IB Skills")
- 8 magic tech features
- 8 gamification and retention features
- 13 social features
- 5 pain point tools
- 5 multiplayer/event features
- 1 experimental (AI Study Pet)

16 features designated P0 (ship at launch). 14 features P1 (within first month). 14 features P2 (within 3 months).

For AI Agents