Skip to main content

AI Coach Knowledge Base

Consolidated reference for domain coaches (Max, Nova, Sage) to use when generating training plans. This document provides quick access to research-backed guidelines, exercise data, and coaching principles.


Quick Reference: Domain Coach Responsibilities

CoachDomainExpertise
MaxTraining & ExecutionExercise selection, programming, technique, volume
NovaScience & ResearchResearch citations, evidence-based recommendations
SageRecovery & WellnessSleep, nutrition, stress, deload, lifestyle

1. Exercise Database Summary

Available Data Per Exercise

The exercise inventory contains:

FieldDescriptionUse Case
name, slugExercise identificationDisplay & lookup
typeIdcompound, isolation, power, etc.Session ordering
movementPatternId7 fundamental patterns + additionalBalance analysis
difficultybeginner, intermediate, advancedUser matching
goalScores0-100 scores for each goalGoal-based selection
mechanicalTension, metabolicStress, muscleDamage0-100Hypertrophy mechanism matching
strengthCurveascending, descending, bell, flatProgramming considerations
recommendedReps/SetsMin/max rangesDefault programming
fatigueImpactlow, moderate, high, very_highSession management
orderInSessionearly, middle, lateSession structure
technicalComplexity1-10User experience matching
jointStressPer joint (0-3)Injury prevention
musclesPrimary, secondary, stabilizerVolume accounting
equipmentRequired equipment listEquipment filtering

Movement Patterns (Balance These)

PatternOppositeExamples
Horizontal PushHorizontal PullBench Press vs Row
Vertical PushVertical PullOHP vs Pull-up
Hip HingeSquatDeadlift vs Squat
Lunge-Walking Lunge
Carry-Farmer's Walk
Anti-RotationRotationPallof Press
Anti-Extension-Plank

14 Muscle Groups

Upper Body: chest, back_lats, back_upper, front_delts, side_delts, rear_delts, biceps, triceps
Lower Body: quads, hamstrings, glutes, calves
Core: abs, obliques

2. Research-Backed Guidelines (Nova's Domain)

Volume Recommendations (Pelland 2024, Schoenfeld 2017)

ExperienceSets/Muscle/WeekNotes
Beginner10-14Focus on technique
Intermediate14-18Standard recommendation
Advanced16-22+May require more

Frequency: 2x/week per muscle is optimal for hypertrophy (Schoenfeld 2016)

Rep Ranges by Goal

GoalRep RangeRIRRest
Strength3-62-33-5 min
Hypertrophy6-121-31.5-3 min
Endurance12-20+1-230-90 sec
Power3-52-33-5 min

Intensity Guidelines (Helms 2018, Refalo 2021)

Training PhaseTarget RPERIR Equivalent
Foundation7-82-3
Building8-91-2
Peaking9-100-1
Deload6-73-4

Tempo (Wilk 2021)

Default: 2-1-2-0 (eccentric-pause-concentric-pause)

  • Hypertrophy: 2-3 second eccentrics
  • Strength: 1-2 second eccentrics
  • Time under tension: 30-60 seconds per set

Exercise Order (Simao 2012)

  1. Most complex/compound first
  2. Priority muscles early
  3. Large → Small muscle groups
  4. Free weights → Machines
  5. Isolation last

Deload Protocols (Pritchard 2024)

MethodVolume ReductionIntensity
Volume Deload40-60% reductionMaintain
Intensity DeloadMaintain10-15% reduction
Full Deload40-60% reduction10-15% reduction

Frequency: Every 4-6 weeks (adjust based on user response)


3. Body Recomposition Guidelines (Sage's Domain)

Deficit Recommendations (Barakat 2020, Garthe 2011)

User StatusWeekly RateDeficit
Higher BF% (>25%)1-1.5% BW/week500-750 kcal
Moderate BF% (15-25%)0.5-1% BW/week300-500 kcal
Lean (<15%)0.25-0.5% BW/week200-300 kcal
BeginnerCan gain muscle in deficit300-500 kcal

Protein Requirements (Morton 2018)

GoalProtein/kg BWNotes
Muscle Building1.6-2.2gHigher end in deficit
Recomp2.0-2.4gPrioritize protein
Fat Loss2.0-2.4gPreserve muscle

Sleep & Recovery (Watson 2017)

Sleep DurationImpact
<6 hours-30% recovery, muscle loss risk
7-9 hoursOptimal for adaptation
>9 hoursDiminishing returns

Recovery Timing

Muscle SizeRecovery Hours
Small (biceps, triceps)24-48
Medium (delts, chest)48-72
Large (back, legs)72-96

4. Session Structure (Max's Domain)

Standard Session Template (60-75 min)

1. General Warm-up (5 min)
- Light cardio: 3-5 min
- Dynamic stretches

2. Movement Prep (5 min)
- Activation drills
- Pattern rehearsal

3. Main Lift (15-20 min)
- Warm-up sets: 2-3
- Working sets: 3-5
- Primary compound

4. Secondary Compound (10-15 min)
- 3-4 sets
- Support the main lift

5. Tertiary/Isolation (15-20 min)
- 2-3 exercises
- 2-3 sets each

6. Finisher (5-10 min)
- Optional high-rep work
- Or conditioning

7. Cool-down (5 min)
- Light stretching
- Mobility work

Warm-up Set Protocol (Ribeiro 2020)

Working WeightWarm-up Sets
Light (<60% 1RM)1-2 sets
Moderate (60-80%)2-3 sets
Heavy (>80%)3-4 sets

Time Budgeting Per Session

Session LengthCompoundsIsolationExercises Total
45 min224
60 min2-32-35-6
75 min33-46-7
90 min3-44-57-8

5. Split Recommendations

By Frequency

Days/WeekRecommended SplitNotes
2-3Full BodyHit all muscles each session
3-4Upper/LowerGood frequency, manageable volume
4-5Push/Pull/LegsPopular, flexible
5-6PPL or Bro SplitAdvanced, high volume

Split Pros/Cons

SplitProsCons
Full BodyHigh frequency, time-efficientFatigue accumulation
Upper/LowerBalanced, recoverableLess specialization
Push/Pull/LegsGreat for hypertrophyRequires 5-6 days
Bro SplitHigh volume per muscleLow frequency

6. Periodization Models

Linear (Beginners)

  • Increase weight weekly
  • Simple and effective
  • Example: +2.5kg/week on compounds

Undulating (Intermediate)

  • Vary rep ranges within week
  • Example: Heavy Mon, Light Wed, Moderate Fri

Block (Advanced)

  • 3-6 week focused phases
  • Accumulation → Transmutation → Realization

7. Goal-Specific Modifications

Strength Focus

  • Lower reps (3-6)
  • Longer rest (3-5 min)
  • Compound emphasis (80%+ of volume)
  • Specific skill practice

Hypertrophy Focus

  • Moderate reps (6-12)
  • Moderate rest (90-180 sec)
  • Mix of compounds and isolation
  • High volume (16-20+ sets/muscle/week)

Fat Loss Focus

  • Maintain intensity
  • Moderate volume (prevent catabolism)
  • Add conditioning work
  • Higher protein, moderate deficit

Body Recomposition

  • Progressive overload priority
  • Protein 2.0-2.4g/kg
  • Slight deficit (300-500 kcal)
  • Adequate sleep (7-9 hrs)
  • Patience (slower progress but sustainable)

8. User-Specific Adaptations

Experience Level Adjustments

FactorBeginnerIntermediateAdvanced
Exercise complexitySimpleModerateComplex
VolumeLowerModerateHigher
IntensityRPE 7-8RPE 8-9RPE 9-10
Frequency2-3x/week3-4x/week4-6x/week
Deload frequencyEvery 6-8 weeksEvery 4-6 weeksEvery 3-4 weeks

Equipment Adaptations

AvailableStrategy
Full gymOptimal exercise selection
LimitedSubstitute with alternatives
Home/minimalBodyweight + dumbbells focus
Hotel gymMachine-based alternatives

Injury Considerations

ConcernApproach
ShoulderAvoid overhead pressing, modify grip
Lower backReduce spinal loading, brace focus
KneeReduce deep squat, leg press alternatives
General sorenessReduce volume, check recovery

9. Coaching Communication Guidelines

Max's Voice (Training)

  • Direct and practical
  • Focus on execution and form
  • Uses concrete examples
  • "Here's exactly how to do this..."

Nova's Voice (Science)

  • Analytical and precise
  • Cites research when relevant
  • Explains the "why"
  • "Research shows that..."

Sage's Voice (Recovery)

  • Warm and supportive
  • Holistic perspective
  • Emphasizes lifestyle
  • "Remember, recovery is when you grow..."

Discussion Format

When coaches discuss a plan:

  1. Each coach presents their perspective
  2. Highlight agreements and trade-offs
  3. Present unified recommendation
  4. Ask user for preferences on key decisions

10. Quick Reference Tables

EMG Activation (ACE Studies)

Chest Exercises (Best to Worst)

  1. Barbell Bench Press (100%)
  2. Pec Deck Machine (98%)
  3. Cable Crossover (93%)
  4. Incline Dumbbell Press (91%)
  5. Dip (89%)

Back Exercises (Best to Worst)

  1. Bent-Over Row (100%)
  2. Pull-up (91%)
  3. Seated Row (83%)
  4. Lat Pulldown (78%)

Shoulder Exercises (Best for Side Delts)

  1. Cable Lateral Raise (100%)
  2. Dumbbell Lateral Raise (83%)
  3. 45° Incline Row (77%)

Common Mistakes to Watch

IssueSolution
Too much volumeStart conservative, add over time
Ignoring recoveryProgram deloads, check sleep/nutrition
Wrong exercise selectionMatch to user's equipment/experience
Ego liftingRPE-based autoregulation
No progression planDefine progressive overload strategy

Document References

For detailed information, coaches can reference:

  • Exercise Database: lib/db/schema-exercise-inventory.ts
  • Research Sources: docs/moplan/plan-generation-v2/09-sources-references.md
  • Volume Guidelines: docs/moplan/plan-generation-v2/02-ten-pillars.md
  • Body Recomp: docs/moplan/plan-generation-v2/03-body-recomposition.md
  • Session Budgeting: docs/moplan/plan-generation-v2/07-session-budgeting-and-predictions.md
  • Warm-up/Cooldown: docs/moplan/plan-generation-v2/08-warmup-cooldown-progression.md
  • Wellness Guide: docs/wellness-guide/ (27 documents)

Last Updated: December 2024