Knowledge Architecture Doc & 100-Triple Domain Graph
Prepared for: Mike (Spring 2026 Practicum)
Nutrition Intake: Oura does not measure caloric or macronutrient intake. We rely strictly on baseline BMR calculations and manual survey inputs. If the user under-eats, the HRV drop will be misattributed to stress rather than malnutrition.
Cycle Variations: The deterministic logic assumes a standard 28-day cycle with clear Follicular/Luteal demarcation via body temperature. Women with PCOS, irregular cycles, or on certain hormonal contraceptives will generate false-positive trigger states.
Protocol Blending: The GPT-5 mini layer generating the monthly copy may mix protocols (e.g., prescribing a somatic brake during a heavy lift session). Strict deterministic guarding (Edge Functions) must gate the context window.
This schema directly maps to your Supabase PostgreSQL relational structure.
| Subject | Predicate | Object |
|---|---|---|
| User_Profile | has_attribute | Chronological_Age |
| User_Profile | has_attribute | Professional_Demands |
| User_Profile | generates | Oura_Access_Token |
| User_Profile | experiences | Cycle_Phase |
| Cycle_Phase | has_state | Follicular_Phase |
| Cycle_Phase | has_state | Ovulatory_Phase |
| Cycle_Phase | has_state | Luteal_Phase |
| Cycle_Phase | has_state | Menstrual_Phase |
| Follicular_Phase | correlates_with | Estrogen_Dominance |
| Luteal_Phase | correlates_with | Progesterone_Dominance |
| Progesterone_Dominance | increases | Core_Body_Temperature |
| Progesterone_Dominance | increases | Basal_Metabolic_Rate |
| Follicular_Phase | increases | Insulin_Sensitivity |
| Luteal_Phase | decreases | Insulin_Sensitivity |
| User_Profile | has_metric | Allostatic_Load |
| Allostatic_Load | is_calculated_by | HRV_Rolling_Average |
| Allostatic_Load | is_calculated_by | Resting_Heart_Rate |
| Assessment_Survey | updates | Psychological_Capital |
| Monthly_Strategy | synthesizes | User_Profile |
| Daily_Action | derives_from | Monthly_Strategy |
| Subject | Predicate | Object |
|---|---|---|
| Oura_API | provides | Sleep_Score |
| Oura_API | provides | Readiness_Score |
| Oura_API | provides | Activity_Score |
| Readiness_Score | incorporates | Heart_Rate_Variability |
| Readiness_Score | incorporates | Resting_Heart_Rate |
| Readiness_Score | incorporates | Body_Temperature_Deviation |
| Sleep_Score | incorporates | Deep_Sleep_Duration |
| Sleep_Score | incorporates | REM_Sleep_Duration |
| Sleep_Score | incorporates | Sleep_Latency |
| Sleep_Score | incorporates | Sleep_Efficiency |
| Activity_Score | incorporates | Active_Calorie_Burn |
| Activity_Score | incorporates | Training_Volume |
| Body_Temperature_Deviation | indicates | Cycle_Phase_Transition |
| Heart_Rate_Variability | indicates | Parasympathetic_Tone |
| Resting_Heart_Rate | indicates | Sympathetic_Load |
| Parasympathetic_Tone | enables | Biological_Recovery |
| Sympathetic_Load | consumes | Biological_Capacity |
| Low_HRV_Trend | flags | Systemic_Fatigue |
| Elevated_Temp_Trend | flags | Luteal_Phase |
| Supabase_Edge_Function | processes | Oura_API_Payload |
| Subject | Predicate | Object |
|---|---|---|
| Follicular_Phase | increases_tolerance_for | Protocol_HIIT |
| Protocol_HIIT | requires | High_Readiness_Score |
| Luteal_Phase | decreases_tolerance_for | Protocol_Heavy_Lifting |
| Low_Readiness_Score | triggers | Protocol_Zone2_Cardio |
| Protocol_Zone2_Cardio | improves | Mitochondrial_Density |
| Assessment_Sedentary_Job | triggers | Protocol_Micro_Movement |
| Protocol_Micro_Movement | mitigates | Insulin_Resistance |
| Luteal_Phase | disrupts | REM_Sleep_Duration |
| Elevated_Core_Temp | delays | Sleep_Latency |
| Protocol_Cold_Room | mitigates | Elevated_Core_Temp |
| Protocol_Cold_Room | accelerates | Sleep_Latency |
| Low_Deep_Sleep | triggers | Protocol_NSDR |
| Protocol_NSDR | restores | Dopamine_Baseline |
| Protocol_NSDR | simulates | Slow_Wave_Sleep |
| Late_Screen_Time | suppresses | Melatonin_Production |
| Melatonin_Production | initiates | Sleep_Architecture |
| Protocol_Digital_Sunset | protects | Melatonin_Production |
| High_Training_Volume | increases_need_for | Deep_Sleep_Duration |
| Protocol_HIIT | is_backed_by | Evidence_Boutcher_2011 |
| Protocol_NSDR | links_to | Asset_Huberman_Audio |
| Subject | Predicate | Object |
|---|---|---|
| Luteal_Phase | increases_demand_for | Nutrient_Magnesium |
| Luteal_Phase | increases_demand_for | Nutrient_Complex_Carbs |
| Nutrient_Magnesium | improves | Slow_Wave_Sleep |
| Nutrient_Magnesium | reduces | Cortisol_Levels |
| Protocol_Hydration | requires | Nutrient_Sodium |
| Protocol_Hydration | requires | Nutrient_Potassium |
| Nutrient_Sodium | regulates | Blood_Volume |
| Blood_Volume | maintains | Optimal_HRV |
| Follicular_Phase | optimizes | Glycogen_Storage |
| Protocol_Fasting | is_contraindicated_in | Luteal_Phase |
| Protocol_Fasting | increases | Cortisol_Levels |
| High_Activity_Score | depletes | Glycogen_Storage |
| Depleted_Glycogen | triggers | Protocol_Carb_Refeed |
| Protocol_Carb_Refeed | lowers | Cortisol_Levels |
| Nutrient_Iron | is_depleted_by | Menstrual_Phase |
| Menstrual_Phase | triggers | Protocol_Iron_Supplementation |
| Protocol_Iron_Supplementation | is_backed_by | Evidence_Grade_High |
| Protocol_Hydration | is_backed_by | Evidence_Grade_High |
| Protocol_Macro_Syncing | is_backed_by | Evidence_Grade_Hedged |
| Evidence_Grade_Hedged | constrains | GPT5_Copy_Generation |
| Subject | Predicate | Object |
|---|---|---|
| Assessment_Low_Control | amplifies | Allostatic_Load |
| High_Allostatic_Load | suppresses | Heart_Rate_Variability |
| High_Allostatic_Load | triggers | Protocol_Somatic_Brake |
| Protocol_Somatic_Brake | stimulates | Vagus_Nerve |
| Vagus_Nerve | increases | Parasympathetic_Tone |
| Protocol_Somatic_Brake | is_backed_by | Evidence_Balban_2023 |
| Assessment_Boundary_Collapse | triggers | Protocol_Psychological_Detachment |
| Protocol_Psychological_Detachment | protects | Sleep_Efficiency |
| Protocol_Psychological_Detachment | is_backed_by | Evidence_Sonnentag_2012 |
| Assessment_Isolation | triggers | Protocol_Active_Constructive_Responding |
| Protocol_Active_Constructive_Responding | builds | Psychological_Capital |
| Psychological_Capital | buffers | Allostatic_Load |
| Protocol_Job_Crafting | increases | Agency_Perception |
| Protocol_Values_Affirmation | blunts | Cortisol_Spike |
| Cortisol_Spike | disrupts | Insulin_Sensitivity |
| Protocol_Values_Affirmation | is_backed_by | Evidence_Sweeney_2016 |
| Monthly_Strategy | prioritizes | Lowest_Scoring_Pillar |
| GPT5_Mini_Agent | translates | Triples_To_Natural_Language |
| Daily_Action | deep_links_to | Asset_Calm_App |
| OptimizeHER_Platform | integrates | All_Domain_Triples |