OptimizeHER

Knowledge Architecture Document (Session 4)

Prepared for: Mike | Entities, Relationships, Data Sources, Risk, & 100 Triples

1. Entity Types

Biological State

User_Profile, Cycle_Phase, Allostatic_Load

Biometric Inputs

Biometric_Signal (HRV, RHR, Temp), Readiness_State

System Architecture

Pillar, Assessment_Survey, Monthly_Strategy

Interventions

Protocol, Third_Party_Asset

Epistemic (Rigor)

Evidence_Base, Evidence_Grade

2. Key Relationships (Ontology Rules)

Biometrics trigger Interventions: [Low_HRV] -> triggers -> [Protocol_Somatic_Brake]
Cycle Phases modulate Baseline: [Luteal_Phase] -> increases_demand_for -> [Magnesium]
Protocols mitigate Friction: [Protocol_Cold_Room] -> mitigates -> [Elevated_Core_Temp]
Assessments contextualize Data: [Assessment_Low_Control] -> amplifies -> [Allostatic_Load]
Epistemic Guarding: [Protocol] -> is_backed_by -> [Evidence_Base]

3. Data Sources

1. Wearable Telemetry (Oura API)

Data: HRV, RHR, Body Temp Deviation, Sleep Architecture.

Usage: Deterministic biological baseline. Refreshes daily.

2. Zero-Party Context (App Surveys)

Data: Perceived agency, psychological detachment, menstrual cycle manual overrides.

Usage: Contextualizes biometric data. Refreshes weekly.

3. Clinical Ground Truth (Static DB)

Data: Meta-analyses, Cochrane reviews, proven protocols.

Usage: Anchors GPT-5 mini outputs to prevent hallucination.

4. Risk Analysis ("What We Don't Know" / KG Training)

Risk 1: Nutrition Data Blindspots

Vulnerability: Oura does not measure caloric or macronutrient intake. If a user under-eats, the HRV drop will be misattributed to stress rather than malnutrition.

Mitigation: Manual "energy availability" check-ins are forced in the app during the Luteal phase.

Risk 2: Biological Edge Cases

Vulnerability: The deterministic logic assumes a standard ovulatory cycle. Women with PCOS, irregular cycles, or on hormonal contraceptives will generate false-positive trigger states.

Mitigation: Onboarding bifurcates the logic tree (Natural Cyclers vs. Suppressed Cyclers).

Risk 3: AI Hallucination Vectors

Vulnerability: The GPT-5 mini layer may hallucinate or blend protocols incorrectly (e.g., prescribing fasting during a heavy luteal phase).

Mitigation: Strict deterministic guarding via Supabase Edge Functions. The LLM only receives pre-approved, Evidence-Graded protocols in its context window.

5. Visual Graph Diagram (VanderBot Export)

[Oura API] --------(provides)--------> [Biometric_Signal (HRV/Temp)]
                                                |
                                           (indicates)
                                                |
[User_Profile] ---(experiences)---> [Cycle_Phase (Luteal)] ---(increases_demand_for)---> [Magnesium]
       |                                        |                                             |
  (has_metric)                             (disrupts)                                    (improves)
       |                                        |                                             |
[Allostatic_Load] <----(amplifies)---- [Assessment_Survey]                              [Deep_Sleep]
       |
   (triggers)
       v
[Protocol_Somatic_Brake] ---(is_backed_by)---> [Evidence_Base: Balban 2023]

6. The 100-Triple Domain Graph Mapping

Explicitly numbered 1-100 to map the comprehensive scale of the database schema.

A. State Context (1-20)

ID	Subject	Predicate	Object
1	User_Profile	has_attribute	Chronological_Age
2	User_Profile	has_attribute	Professional_Demands
3	User_Profile	generates	Oura_Access_Token
4	User_Profile	experiences	Cycle_Phase
5	Cycle_Phase	has_state	Follicular_Phase
6	Cycle_Phase	has_state	Ovulatory_Phase
7	Cycle_Phase	has_state	Luteal_Phase
8	Cycle_Phase	has_state	Menstrual_Phase
9	Follicular_Phase	correlates_with	Estrogen_Dominance
10	Luteal_Phase	correlates_with	Progesterone_Dominance
11	Progesterone_Dominance	increases	Core_Body_Temperature
12	Progesterone_Dominance	increases	Basal_Metabolic_Rate
13	Follicular_Phase	increases	Insulin_Sensitivity
14	Luteal_Phase	decreases	Insulin_Sensitivity
15	User_Profile	has_metric	Allostatic_Load
16	Allostatic_Load	is_calculated_by	HRV_Rolling_Average
17	Allostatic_Load	is_calculated_by	Resting_Heart_Rate
18	Assessment_Survey	updates	Psychological_Capital
19	Monthly_Strategy	synthesizes	User_Profile
20	Daily_Action	derives_from	Monthly_Strategy

B. Biometrics (21-40)

ID	Subject	Predicate	Object
21	Oura_API	provides	Sleep_Score
22	Oura_API	provides	Readiness_Score
23	Oura_API	provides	Activity_Score
24	Readiness_Score	incorporates	Heart_Rate_Variability
25	Readiness_Score	incorporates	Resting_Heart_Rate
26	Readiness_Score	incorporates	Body_Temperature_Deviation
27	Sleep_Score	incorporates	Deep_Sleep_Duration
28	Sleep_Score	incorporates	REM_Sleep_Duration
29	Sleep_Score	incorporates	Sleep_Latency
30	Sleep_Score	incorporates	Sleep_Efficiency
31	Activity_Score	incorporates	Active_Calorie_Burn
32	Activity_Score	incorporates	Training_Volume
33	Body_Temperature_Deviation	indicates	Cycle_Phase_Transition
34	Heart_Rate_Variability	indicates	Parasympathetic_Tone
35	Resting_Heart_Rate	indicates	Sympathetic_Load
36	Parasympathetic_Tone	enables	Biological_Recovery
37	Sympathetic_Load	consumes	Biological_Capacity
38	Low_HRV_Trend	flags	Systemic_Fatigue
39	Elevated_Temp_Trend	flags	Luteal_Phase
40	Supabase_Edge_Function	processes	Oura_API_Payload

C. Movement & Sleep (41-60)

ID	Subject	Predicate	Object
41	Follicular_Phase	increases_tolerance_for	Protocol_HIIT
42	Protocol_HIIT	requires	High_Readiness_Score
43	Luteal_Phase	decreases_tolerance_for	Protocol_Heavy_Lifting
44	Low_Readiness_Score	triggers	Protocol_Zone2_Cardio
45	Protocol_Zone2_Cardio	improves	Mitochondrial_Density
46	Assessment_Sedentary	triggers	Protocol_Micro_Movement
47	Protocol_Micro_Movement	mitigates	Insulin_Resistance
48	Luteal_Phase	disrupts	REM_Sleep_Duration
49	Elevated_Core_Temp	delays	Sleep_Latency
50	Protocol_Cold_Room	mitigates	Elevated_Core_Temp
51	Protocol_Cold_Room	accelerates	Sleep_Latency
52	Low_Deep_Sleep	triggers	Protocol_NSDR
53	Protocol_NSDR	restores	Dopamine_Baseline
54	Protocol_NSDR	simulates	Slow_Wave_Sleep
55	Late_Screen_Time	suppresses	Melatonin_Production
56	Melatonin_Production	initiates	Sleep_Architecture
57	Protocol_Digital_Sunset	protects	Melatonin_Production
58	High_Training_Volume	increases_need_for	Deep_Sleep_Duration
59	Protocol_HIIT	is_backed_by	Evidence_Boutcher
60	Protocol_NSDR	links_to	Asset_Huberman_Audio

D. Nutrition (61-80)

ID	Subject	Predicate	Object
61	Luteal_Phase	increases_demand_for	Nutrient_Magnesium
62	Luteal_Phase	increases_demand_for	Nutrient_Complex_Carbs
63	Nutrient_Magnesium	improves	Slow_Wave_Sleep
64	Nutrient_Magnesium	reduces	Cortisol_Levels
65	Protocol_Hydration	requires	Nutrient_Sodium
66	Protocol_Hydration	requires	Nutrient_Potassium
67	Nutrient_Sodium	regulates	Blood_Volume
68	Blood_Volume	maintains	Optimal_HRV
69	Follicular_Phase	optimizes	Glycogen_Storage
70	Protocol_Fasting	contraindicated_in	Luteal_Phase
71	Protocol_Fasting	increases	Cortisol_Levels
72	High_Activity	depletes	Glycogen_Storage
73	Depleted_Glycogen	triggers	Protocol_Carb_Refeed
74	Protocol_Carb_Refeed	lowers	Cortisol_Levels
75	Nutrient_Iron	is_depleted_by	Menstrual_Phase
76	Menstrual_Phase	triggers	Protocol_Iron_Supps
77	Protocol_Iron_Supps	is_backed_by	Evidence_Grade_High
78	Protocol_Hydration	is_backed_by	Evidence_Grade_High
79	Protocol_Macro_Sync	is_backed_by	Evidence_Grade_Hedged
80	Evidence_Grade_Hedged	constrains	GPT5_Copy_Generation

E. Resilience & Agency (81-100)

ID	Subject	Predicate	Object
81	Assessment_Low_Control	amplifies	Allostatic_Load
82	High_Allostatic_Load	suppresses	Heart_Rate_Variability
83	High_Allostatic_Load	triggers	Protocol_Somatic_Brake
84	Protocol_Somatic_Brake	stimulates	Vagus_Nerve
85	Vagus_Nerve	increases	Parasympathetic_Tone
86	Protocol_Somatic_Brake	is_backed_by	Evidence_Balban_2023
87	Assessment_Boundary_Collapse	triggers	Protocol_Psych_Detach
88	Protocol_Psych_Detach	protects	Sleep_Efficiency
89	Protocol_Psych_Detach	is_backed_by	Evidence_Sonnentag
90	Assessment_Isolation	triggers	Protocol_ACR
91	Protocol_ACR	builds	Psychological_Capital
92	Psychological_Capital	buffers	Allostatic_Load
93	Protocol_Job_Crafting	increases	Agency_Perception
94	Protocol_Values_Affirmation	blunts	Cortisol_Spike
95	Cortisol_Spike	disrupts	Insulin_Sensitivity
96	Protocol_Values_Affirmation	is_backed_by	Evidence_Sweeney
97	Monthly_Strategy	prioritizes	Lowest_Scoring_Pillar
98	GPT5_Mini_Agent	translates	Triples_To_Language
99	Daily_Action	deep_links_to	Asset_Calm_App
100	OptimizeHER_Platform	integrates	All_Domain_Triples