fitness-program

Fitness Program — Full Design Pipeline

An agent team collaborates to generate goal-based program design → weekly schedule → exercise guide document → nutrition pairing chart → progress tracking template all at once.

Execution Modes

Agent Team — 4 agents communicate directly via SendMessage and perform cross-validation.

Agent Roster

Agent	File	Role	Type
program-architect	.claude/agents/program-architect.md	Program design, periodization, scheduling	general-purpose
exercise-guide	.claude/agents/exercise-guide.md	Exercise descriptions, form guides, substitutions	general-purpose
nutrition-linker	.claude/agents/nutrition-linker.md	Nutrition strategy per workout, supplements, timing	general-purpose
template-builder	.claude/agents/template-builder.md	Logs, tracking sheets, evaluation forms	general-purpose

Workflow

Phase 1: Preparation (Orchestrator handles directly)

1. Extract from user input:
   • Goal: hypertrophy / strength / fat loss / fitness improvement / rehabilitation
   • Fitness level: beginner / intermediate / advanced, training history
   • Available resources: X sessions/week, X minutes/session, equipment (gym / home / bodyweight)
   • Physical info (optional): sex, age, height, weight
   • Injury history (optional): area, current condition
   • Existing program (optional): currently running program
2. Create a _workspace/ directory at the project root
3. Organize inputs and save to _workspace/00_input.md
4. Determine execution mode based on request scope

Phase 2: Team Assembly and Execution

Order	Task	Owner	Depends on	Output
1	Program design + weekly schedule	architect	none	01_program_design.md, 02_weekly_schedule.md
2a	Exercise guide document	guide	Task 1	03_exercise_guide.md
2b	Nutrition pairing chart	linker	Task 1	04_nutrition_plan.md
3	Progress tracking template	builder	Tasks 1, 2a, 2b	05_tracking_template.md

Tasks 2a (exercise guide) and 2b (nutrition pairing) run in parallel.

Inter-agent communication flow:

• architect completes → sends exercise list and precautions to guide, sends intensity/volume/goal to linker, sends periodization schedule to builder
• guide completes → sends high-intensity exercise list to linker, sends logging items to builder
• linker completes → sends nutrition tracking items to builder
• builder integrates all information to create the template; if missing items are found, requests clarification from the relevant agent

Phase 3: Integration and Final Deliverables

1. Review all files in _workspace/
2. Verify consistency across program–schedule–guide–nutrition–template
3. Report final summary to the user:
   • Program design doc — 01_program_design.md
   • Weekly schedule — 02_weekly_schedule.md
   • Exercise guide — 03_exercise_guide.md
   • Nutrition pairing chart — 04_nutrition_plan.md
   • Tracking template — 05_tracking_template.md

Mode by Request Scope

User Request Pattern	Execution Mode	Agents Involved
"Build me a full workout program"	Full Pipeline	All 4
"Just the weekly workout schedule"	Schedule Mode	architect only
"Teach me squat form"	Guide Mode	guide only
"Link a bulk-up diet" (program exists)	Nutrition Mode	linker only
"Make a workout log"	Template Mode	builder only
"Analyze this program" (existing file)	Analysis Mode	architect + guide

Using existing files: If the user provides an existing program, copy it to _workspace/01_program_design.md and skip the architect.

Data Transfer Protocol

Strategy	Method	Purpose
File-based	_workspace/ directory	Store and share primary deliverables
Message-based	SendMessage	Real-time key information transfer, revision requests
Task-based	TaskCreate/TaskUpdate	Progress tracking, dependency management

File naming convention: {order}_{agent}_{deliverable}.{extension}

Error Handling

Error Type	Strategy
Insufficient user info	Design using conservative (beginner) baseline; note "fitness level unconfirmed"
Injury history	Exclude or substitute exercises for the affected area + "consult a specialist" note
Equipment limitations	Compose with substitute exercises within available equipment
Agent failure	Retry once → if still failing, proceed without that deliverable and note the omission in the report
Program inconsistency	Request revision from architect (up to 2 times)

Test Scenarios

Normal Flow

Prompt: "I'm a beginner at the gym and want a hypertrophy-focused program, 4 days a week. 178cm, 75kg, 28-year-old male." Expected output:

• Program: upper/lower 4-day split, 12-week periodization (adaptation → accumulation → intensification → deload)
• Schedule: 4 sessions/week × 60 min, sets/reps/RPE specified per exercise
• Guide: form descriptions + substitutions for all exercises in the program (15–20 exercises)
• Nutrition: bulk-up calories (TDEE+300), macros, pre/post-workout timing
• Template: daily log, weekly summary, 4-week evaluation form, body composition tracker

Existing File Flow

Prompt: "Here's my current PPL routine — can you pair it with a diet?" + program file attached Expected output:

• Copy existing program to _workspace/01_program_design.md
• Nutrition mode: deploy linker, analyze existing program intensity, generate nutrition pairing chart

Error Flow

Prompt: "I have a herniated disc — create a workout program for me." Expected output:

• Injury history applied: exclude high-lumbar-load exercises (deadlifts, barbell squats)
• Include core stabilization exercises, suggest substitutes (leg press, machine-based)
• All exercises marked with "lumbar caution" ⚠️ + "consult orthopedics/rehabilitation medicine"
• Progressive overload set more conservatively

Per-Agent Extended Skills

Agent	Extended Skill	Purpose
exercise-guide	exercise-biomechanics	Exercise biomechanics, muscle activation, substitution exercises
program-architect, template-builder	periodization-engine	Periodization design, volume/intensity calculation, deload strategy
chitect, template-builder	periodization-engine	Periodization design, volume/intensity calculation, deload strategy