Mo Documentation

Your AI-powered fitness coach.

---

Documentation Structure

docs/
├── README.md              ← You are here
│
├── coach-ai/              # Mo Coach AI System
│   ├── README.md          # Overview and architecture
│   ├── profiles.md        # 8 coach personalities
│   ├── tasks.md           # Task system and phases
│   └── personalization.md # Memory and user context
│
├── moplan/                # Interactive Workout Planning
│   ├── README.md          # Overview
│   ├── planning-flow.md   # 8-phase planning wizard
│   ├── plan-generation.md # Engine architecture
│   ├── workout-sessions.md # Session structure
│   └── database-schema.md # Plan-related tables
│
├── product/               # Product Documentation
│   ├── README.md          # Index
│   ├── 01-brand-and-vision.md
│   ├── 02-product-definition.md
│   ├── 03-technical-architecture.md
│   ├── 04-ui-ux-design.md
│   ├── 05-development-plan.md
│   └── 06-deployment-and-launch.md
│
└── wellness-guide/        # Fitness & Wellness Reference

---

Quick Start

Coach AI System

Mo uses an intelligent 8-coach system:

Coach	Type	Domain
Max	Domain Expert	Training & Execution
Nova	Domain Expert	Science & Insights
Sage	Domain Expert	Recovery & Lifestyle
Sam	Personality	The Buddy
Ace	Personality	The Minimalist
Chip	Personality	The Comedian
Rex	Personality	The Competitor
Mo	Adaptive	All-in-one

→ Full documentation

MoPlan

Interactive workout planning with 8 phases:

1. Goal Selection
2. Goal Quantification
3. Activity Selection
4. Frequency & Schedule
5. Equipment & Constraints
6. Plan Generation
7. Review & Activation
8. Living Plan (ongoing)

→ Full documentation

---

Implementation

lib/coaches/           # Coach AI implementation
├── profiles.ts        # Coach definitions
├── tasks.ts           # Task configurations
├── builder.ts         # Prompt composition
├── personalization.ts # User context builder
├── memory.ts          # Memory store
└── index.ts           # All exports

app/(app)/plan/        # MoPlan UI
app/api/v1/plans/      # MoPlan API

---

Tech Stack

Layer	Technology
Frontend	Next.js 14, React, TypeScript, Tailwind CSS
Backend	Next.js API Routes
Database	PostgreSQL with Drizzle ORM
Auth	Clerk
AI	Anthropic Claude
Hosting	Vercel