MoPlan - Interactive Workout Planning
Coach-guided workout planning that creates personalized training programs.
Location: app/(app)/plan/, app/api/v1/plans/
Overview
MoPlan transforms workout planning from a static form into an interactive, coach-guided experience where users collaborate with AI coaches to create personalized training programs.
Coach Roles in Planning
MoPlan uses the 3+1 coach model:
Domain Experts (Always Present)
| Coach | Role in Planning |
|---|---|
| Max | Designs workout structure, volume, splits, exercise selection |
| Nova | Analyzes goal feasibility, provides scientific rationale |
| Sage | Ensures adequate rest, prevents burnout |
Personality Coach (User's Choice)
Sam, Ace, Chip, Rex, or Mo deliver the final message in the user's preferred communication style.
Coach Flow
User Input → Domain Experts Analyze → Personality Coach Summarizes
│ │ │
│ ├── Max: Training design │
│ ├── Nova: Feasibility ├── Delivers in user's
│ └── Sage: Recovery │ preferred style
│ │
└────────────────────────────────────────┘
Documentation
| Document | Description |
|---|---|
| planning-flow.md | 8-phase interactive planning wizard |
| plan-generation.md | Engine architecture and algorithms |
| plan-generation-v2/ | Enhanced plan generation with 10 Pillars |
| workout-sessions.md | Session structure and tracking |
| database-schema.md | All plan-related database tables |
Plan Generation V2 (NEW)
Comprehensive science-based plan generation documentation:
| Document | Description |
|---|---|
| 01-flow-and-ui.md | Complete planning flow (Steps 1-9) |
| 02-ten-pillars.md | The 10 Pillars of science-based design |
| 03-body-recomposition.md | Body recomposition guide |
| 04-execution-modes.md | Training modes & techniques |
| 05-exercise-database.md | Exercise database schema |
| 06-implementation.md | Algorithm & implementation |
Quick Reference
Planning Phases
| Phase | Primary Coach | Description |
|---|---|---|
| 1. Goal Selection | All | Select outcome goals (Build Muscle, Lose Fat, etc.) |
| 2. Goal Quantification | Nova | Set targets, timeline, feasibility score |
| 3. Activity Selection | Max | Choose activities (Gym, Running, etc.) |
| 4. Frequency & Schedule | Max + Sage | Set weekly frequency and days |
| 5. Equipment & Constraints | Max | Equipment access, injuries, preferences |
| 6. Plan Generation | All | AI generates personalized plan |
| 7. Review & Activation | All | User reviews and commits |
| 8. Living Plan | All | Ongoing adjustments and tracking |
Key Parameters
| Category | Examples |
|---|---|
| Goals | Strength, Hypertrophy, Fat Loss, Endurance |
| Periodization | Linear, Undulating (DUP), Block |
| Splits | Full Body, Upper/Lower, Push/Pull/Legs |
| Frequency | 3-6 days/week |
| Session Duration | 30-90 minutes |
Implementation
app/
├── (app)/plan/
│ ├── page.tsx # Plan list/dashboard
│ ├── new/page.tsx # Planning wizard
│ └── [id]/page.tsx # Plan details
│
├── api/v1/plans/
│ ├── route.ts # Plan CRUD
│ ├── [planId]/
│ │ ├── route.ts # Single plan operations
│ │ ├── goals/ # Goal management
│ │ ├── generate/ # AI plan generation
│ │ └── activate/ # Plan activation
│ │
│ └── sessions/ # Workout session APIs
Related Docs
- Coach AI System - Coach profiles and prompt building
- Personalization - Memory and user context