Application Documentation
Overview
Deltaset generates adaptive strength training programs. Each week is built from your stored preferences and recent performance, then converted into daily sessions that fit within your time and equipment limits. Your time is a ceiling, so a session can finish early when additional work is not useful. All selections and volumes are transparent and traceable to the rules below.
Constants & Limits
- BASE_SETS: HYP=12, GEN=9, STR=6
- RIR target: HYP=2, GEN=2.5, STR=1.5
- MAJOR/MINOR ranges: majors 8–20; minors 4–12
- Soft overage: +1 (major), +2 (minor) beyond the configured ceiling when safe accessory top-ups need room.
- Per-day exercise caps: 4 exercises at ≤35 min, 5 at ≤45, 6 at ≤60, 7 at ≤75, and 8 above that; sets per exercise: 2–4.
- Padding floor: explicit floor padding targets 92% of day minutes by adding sets to existing blocks.
- Work time: most rep-based sets estimate 3–4 sec of work per rep plus rest; timed exercises use their prescribed seconds.
Split Selection
- Auto rules: <=2 days → Full Body; 3 → Full Body unless >=60 min; 4 → Upper/Lower; 5+ → PPL (if equipment/minutes sufficient) else Upper/Lower.
- Overrides: Strength → Upper/Lower; limited equipment → Full Body; severe injury → Full Body; rationale stored.
- Skeletons: Upper: [horizontal press, horizontal pull, vertical pull]; Lower: [squat, hinge].
- Templates: Supported splits include FULL_BODY, UPPER_LOWER, PPL, BRO, and CUSTOM.
Weekly Targets & Volume Credits
- Secondary Credits: Volume tracking now accounts for secondary muscle activation. Compound movements give partial credit to assistance muscles (e.g., Bench Press gives 0.4 sets to Triceps; Squats give 0.4 to Glutes and 0.25 to Hamstrings).
- Differentiation: Base volume is applied to major muscles (chest, back, quads, etc.). Minor muscles (biceps, triceps, calves, etc.) target ~70% of the base volume.
- Adjustments: training frequency scaling (1 day ×0.5, 2 ×0.8, 3–4 ×1.0, 5 ×1.1, 6–7 ×1.2); age >40 ×0.8; experience >5y ×1.1; specialization +40%; injuries (MILD 0.7, MOD 0.4, SEV 0.0).
- Hypertrophy autoregulation: Uses a 42-day window to evaluate recovery. Consistent good performance can add +1 set; poor recovery, significant rep drops, or missed sessions can trigger reductions or a deload week.
- Clamping: autoregulated changes are constrained by major/minor ceilings; final top-up ceilings allow the configured soft overage.
Exercise Pool & Normalization
- Equipment: normalize incoming tokens (cable/cables, band/bands, smith/smith machine, landmine attachment, pull-up bar variants); only keep exercises whose equipment ⊆ user equipment.
- Load caps: clamp target loads using user-reported max loads and increments; otherwise fall back to default increments. If maxed out, switch to lateral progression (reps/tempo).
- Prescription Units: Supports REPS and SECONDS (timed). Units are inferred from name (e.g., "Plank") or pattern (CARRY) if not explicitly set.
- Exclusions: discard candidates that train a severely injured muscle.
- Metadata: pattern (e.g., HORIZONTAL_PULL), liftType (COMPOUND/ACCESSORY), biasTags, unilateral, rep span.
Day Construction
Plan generation uses a weekly allocation pass followed by an exercise-placement pass. It aims to satisfy volume and time constraints, then emits warnings when constraints prevent perfect coverage.
- 1. Weekly allocation: The planner assigns target sets to muscles across valid split days while estimating time per set and respecting the per-day time cap.
- 2. Exercise placement: Fills allocated sets with compound passes first, then accessories. Prefers patterns and biases that satisfy coverage expectations.
- 3. Cleanup: Adds safe accessory top-ups for spare time, merges or drops awkward single-set blocks, enforces exercise-count caps, and applies eligible supersets.
- Compact Full Body: Special logic for short (<=45m) full-body hypertrophy sessions to prioritize major compound anchors while protecting key minor muscles.
Variety & Determinism
- Default: selection is preference-weighted and keeps suitable exercises consistent when possible.
- Prefer variety: repeat penalties increase, recent exercises from the last 21 days are penalized, and deterministic weekly jitter breaks ties.
- Coverage: The planner uses "Coverage Expectations" to ensure a variety of patterns (e.g., ensuring both Squat and Knee Extension for Quads) and regional biases (e.g., Delt Medial).
Rest & Time Budget
- Base ranges: HYP compound 120s, accessory 90s; GEN compound 120-150s, accessory 90-120s; STR compound 150-180s, accessory 120-150s.
- Auto-Adjustment: Recent sessions with large rep drops near target RIR can trigger a "REST_ADVICE" intervention, adding 15-30s to future sets.
- Time management: the time budget is a ceiling; over-budget days trim accessory rest first, then compound rest, then lower-priority sets.
Top-Up, Padding & Soft Overage
- Global top-up: after initial placement, the planner can spend up to 60% of total spare time on eligible low-fatigue accessory sets.
- Ceilings: top-ups respect the greater of the target or configured max volume, plus the soft overage allowance.
- Floor padding: Pads short sessions to 92% of target minutes by adding sets to existing blocks (typically accessories).
Regional Bias & Coverage
Certain movements carry biasTags (e.g., CHEST_UPPER, DELT_MEDIAL, BACK_LATS).
- Replacement Search: Prefers alternatives that preserve the same regional emphasis.
- Coverage Expectations: The planner tracks patterns and biases weekly to ensure a balanced stimulus (e.g., ensuring vertical pull is covered alongside horizontal pull).
Replacements
- Filter: normalized equipment, injuries, preference score != -1.
- Tiers: pattern + overlapping muscles + matching bias → pattern + overlapping muscles → compound overlap → accessory overlap.
- Scoring: overlap + primary-muscle match + preference + compound bonus − primary mismatch − duplicate − recency.
Exercise Catalog UI
- Highlighting: unavailable exercises show badges indicating the limiting factor (equipment, injury, progression cap).
- Filters: toggle available-only, unavailable-only, or the full list.
- Editing: unified exercise form for adding/editing; gate actions to admin users.
Logging & Progression
- Quality Scoring: Each session is scored for quality (0.0 to 1.0) based on RIR and rep performance relative to targets.
- Trend Analysis: Tracks quality trends (UP, FLAT, DOWN) over the last 5 sessions to decide on loading.
- Effort Zones: Classifies effort as UNDER, PRODUCTIVE, or OVER based on goal-specific RIR ranges.
- Decision Logic:
- LOAD: High quality + UP trend or consistent productive work.
- REPS: Quality needs proof or effort was UNDER/OVER target.
- HOLD: Repeating prescription for consistency.
- DELOAD: Sustained quality drop or severe overshoot.
- Assistance: Supports negative load (assistance) for bands/bodyweight; progression reduces assistance.
Coaching Interventions
Deltaset tracks diagnostic signals to explain automatic program adjustments. These are informational unless an optional training technique requires a response.
- Novelty Ramp: Gradually introduces new high-risk movement patterns (squats, hinges) over 2-4 exposures before allowing aggressive loading.
- Stall Breaker: Offers optional myo-reps when progress on a hypertrophy accessory has stalled. The final regular set is followed by 3-5-rep mini-sets with 20-second rests; mini-sets count toward workload but not ordinary load progression.
- Rest Advice: Suggests increasing rest time if a significant rep drop is detected across sets.
- Volume Governor: Issues warnings if workload or hard sets jump too sharply in a single week.
- Equipment Cap: Suggests lateral progression (higher reps, slower tempo) when you've maxed out available equipment.
Novelty, rest, workload, and equipment messages do not need to be dismissed or marked complete. Only optional modifiers such as myo-reps ask whether you performed them.
Profile & Avatars
- Fields: goal, training days, minutes, specialization, injuries, equipment, and personal stats.
- Avatar Uploads: Optimized via Sharp (WebP) and stored in S3.