Bipolar Disorder — acute mania + bipolar depression + maintenance (APA 2024; CANMAT/ISBD 2018; BALANCE Geddes Lancet 2010)
Bipolar disorder dossier — APA 2024 + CANMAT/ISBD 2018 Yatham + NICE 2024 + BALANCE Geddes Lancet 2010 + STEP-BD Sachs NEJM 2007 Axis 1 Acute mania: lithium 300 TID target 0.8–1.2 OR valproate 20–30 mg/kg target 50–125; combo with SGA for YMRS ≥30 or psychotic features Axis 2 Bipolar depression: quetiapine 300 QHS, lurasidone 40–120 with food, cariprazine 1.5–3, lamotrigine slow-titrate to 200; NEVER antidepressant monotherapy (STEP-BD Sachs NEJM 2007) Axis 3 Maintenance: lithium preferred per BALANCE (Geddes Lancet 2010) target 0.6–0.8; lifelong for BP I; lamotrigine for depression-predominant BP II Severity triggers (9): severe_mania_ymrs_30, active_si_bipolar, psychotic_features_in_mania, catatonia_in_bipolar (Bush-Francis), lithium_toxicity, nms_on_antipsychotic, pregnancy_on_valproate, mixed_features_with_si (NEW — highest SI risk phenotype, cross-routes to psych.suicidality.ed.core.v1), rapid_cycling_emergence (NEW — discontinue antidepressant, optimise mood stabiliser, refer specialist) Three setting playbooks: ED (agitation containment + disposition), inpatient (stabilisation to therapeutic levels), outpatient (lifelong maintenance + IPSRT/CBT + LAI aripiprazole for non-adherence per Calabrese AJP 2017) Sibling differentiation vs psych.depression.core.v1 — antidepressant monotherapy contraindicated in bipolar; cross-routes to psych.suicidality.ed.core.v1 (mixed-features SI), psych.first-episode-psychosis.core.v1 (mood-incongruent psychosis), psych.alcohol_withdrawal.core.v1 + psych.opioid_use_disorder.core.v1 (substance-induced mania) Deepened 2026-05-14 (shard-5-obped-id depth-pass-1): authored co-located _briefs/psych.bipolar-disorder.core.v1.md (sepsis-template-style — Frame, phenotype matrix 9-axis, settings 5-tier, Bayesian linkage YMRS+lithium-level+CK+MDQ LRs, severity triggers gap analysis, 12-phase author order, Stage-A API checklist, schema proposal cache) + _research-bundles/psych.bipolar-disorder.core.v1.md (companion bundle anchoring APA 2024, CANMAT/ISBD 2018, NICE 2024, STEP-BD, BALANCE, Cipriani 2005, BOLDER, Loebel lurasidone, Durgam cariprazine, Pompili 2013, Calabrese LAI 2017, Pagnin ECT 2004). Bumped last_reconciled 2026-05-13 → 2026-05-14. Deepened 2026-05-14: fixed broken pointers — manifest blanked (out-of-shard-scope per peds.febrile-infant / psych.suicidality / psych.alcohol_withdrawal precedent); design_brief now resolves to authored co-located brief. Deepened 2026-05-14: repointed 4 unresolved workup IDs to registered umbrellas — workup.catatonia_screen → workup.delirium (DELIRIUMS workup covers catatonia + reversibles); workup.lithium_toxicity → workup.encephalopathy (lithium tox presents as AMS); workup.nms_screen → workup.hyperthermic_toxidromes (covers SS/NMS/MH exact match); workup.substance_induced_mania → workup.severe_agitation (5-fold differential including drug intox). Deepened 2026-05-14: removed 3 unregistered calculator IDs (calc.ymrs, calc.cssrs, calc.bmi) — YMRS workflow remains embedded in workup actions + severity_triggers (severe_mania_ymrs_30) + Axis 1 step_up_when language; C-SSRS referenced via workup.suicide_risk (registered umbrella); BMI monitoring continues via panel.glucose_a1c + setting_playbook narratives. All three flagged for future clinical-tools-registry batch. Phenotype matrix (subtype × current-episode × psychotic × rapid-cycling × catatonia × substance-induced × seasonal × postpartum × treatment-resistant) is encoded indirectly via severity_triggers + setting_playbooks + sibling_differentiation. First-class TS field for phenotype matrix is schema-blocked — see docs/framework-audit/shard-5-obped-id-state.md Schema-blocked queue. Bayesian linkage (MDQ LR+ ≈ 7 / LR− ≈ 0.3 in psychiatric outpatients per Hirschfeld 2000; family-history of BP I in 1st-degree relative LR+ ≈ 7–10 for bipolar in MDE presentation; YMRS ≥30 LR+ ≈ 8 for inpatient need; classic euphoric mania LR+ ≈ 3 for lithium response per Bowden 2001; mixed/rapid-cycling LR− ≈ 0.5 for lithium response → valproate preferred; lithium serum >1.5 LR+ ≈ 8 for toxicity, haemodialysis at >4.0 or >2.5 + symptoms per EXTRIP 2015; CK ≥1000 + temp ≥38 + rigidity on AP LR+ ≈ 15 for NMS per Caroff 2015; T_treat = moderate-severe YMRS = mood stabiliser + SGA; T_test = mild BP II hypomania without functional impairment = watchful waiting + MDQ-tracked; cross-dossier routing to psych.suicidality.ed.core.v1 + psych.depression.core.v1 + psych.first-episode-psychosis.core.v1 + psych.alcohol_withdrawal.core.v1 documented in co-located research bundle). ROS/DDx LR seed data audited by npm run audit:ros-ddx-coverage (cross-cutting; not touched by this shard). CRITICAL anti-pattern warnings baked in: (1) NEVER antidepressant monotherapy in bipolar (STEP-BD Sachs NEJM 2007); (2) valproate absolute contraindication in pregnancy (FDA 2013 black-box); (3) lamotrigine slow titration mandatory (SJS); halve dose with valproate; (4) lurasidone with food ≥350 kcal; (5) olanzapine IM no concurrent IM benzodiazepine; (6) ziprasidone QTc ECG; (7) carbamazepine HLA-B*15:02 Asian-ancestry screen; (8) lithium narrow therapeutic index — Q5-7d levels titration; dehydration/NSAID/ACEI/diuretic precipitate toxicity; (9) do not discontinue mood stabiliser abruptly — rebound mania within weeks (Suppes 1991); (10) antidepressant 8-week post-remission discontinuation to minimise switch risk; (11) mixed features = highest SI risk → C-SSRS at every visit; (12) sleep deprivation = mania trigger (Harvey 2008). PRODUCTION blockers: (1) calc.ymrs + calc.cssrs + calc.bmi not in clinical-tools-registry — flagged for future calc-registry batch; (2) RxCUIs need RxNav validation via scripts/research/rxnav-validate.ts; (3) targeted test file pending (relies on dossier-contract.test.ts); (4) ECT atoms (number of sessions, bilateral vs unilateral, frequency) not yet registered; (5) prisma/seed/manifests/ pointer out-of-shard-scope per precedent — manifest field blanked.
Entry points (7)
- symptomElevated/expansive/irritable mood + increased energy ≥1 week (mania) or ≥4 days (hypomania) (DSM-5-TR 2022 criterion A)acute_mania_hypomania
- symptomMajor depressive episode in patient with prior mania or hypomania (DSM-5-TR 2022; APA 2024)bipolar_depressive_episode
- symptomManic or depressive episode with ≥3 features of opposite polarity (DSM-5-TR 2022 mixed-features specifier)mixed_features
- symptomGrandiose or persecutory delusions, hallucinations during manic episode (DSM-5-TR 2022; APA 2024)psychotic_features_in_mania
- symptom≥4 mood episodes in 12 months (DSM-5-TR 2022 rapid-cycling specifier; CANMAT/ISBD 2018 Yatham)rapid_cycling_pattern
- problem_listKnown bipolar disorder with breakthrough mania, hypomania, depression, or mixed state (APA 2024)known_bipolar_relapse
- historyManic or hypomanic switch during antidepressant treatment (APA 2024; STEP-BD Sachs NEJM 2007)antidepressant_induced_mania
Required inputs (19)
- agerequireddemographic • used at CONTEXTDrug selection and dose adjustment; adolescent vs adult vs geriatric (APA 2024; CANMAT/ISBD 2018 Yatham)
- sex_and_pregnancy_statusrequireddemographic • used at CONTEXTValproate contraindicated in pregnancy (FDA 2013 black-box); lithium Ebstein risk low but requires shared decision-making (APA 2024; CANMAT/ISBD 2018)
- ymrs_scorerequiredsymptom • used at RISK_STRATIFICATIONYoung Mania Rating Scale stratifies acute mania severity and tracks response (YMRS Young 1978; APA 2024)
- phq9_or_madrs_scoresymptom • used at RISK_STRATIFICATIONPHQ-9 or MADRS stratifies bipolar depression severity (APA 2024; CANMAT/ISBD 2018 Yatham)
- suicidality_assessmentrequiredsymptom • used at RED_FLAGSC-SSRS — bipolar carries 20–30× population suicide risk (Pompili Bipolar Disord 2013; APA 2024)
- mood_episode_historyrequiredhistory • used at CONTEXTNumber, polarity, and timing of prior episodes — determines BP I vs BP II, rapid cycling (DSM-5-TR 2022; APA 2024)
- prior_mood_stabiliser_responserequiredhistory • used at CONTEXTPrior lithium / valproate / lamotrigine / SGA response guides re-selection (APA 2024; CANMAT/ISBD 2018 Yatham)
- substance_userequiredhistory • used at CONTEXTComorbid SUD in >40% of bipolar — worsens course, affects drug choice (APA 2024; CANMAT/ISBD 2018)
- medical_comorbidityrequiredhistory • used at CONTEXTRenal disease affects lithium; hepatic disease affects valproate; metabolic syndrome affects SGA choice (APA 2024; CANMAT/ISBD 2018 Yatham)
- current_medsrequiredmedication • used at CONTEXTIdentify current mood stabilisers, antidepressants (discontinue if manic switch), CYP interactions, QTc load (APA 2024)
- bmprequiredlab • used at INITIAL_WORKUPBaseline renal function for lithium; electrolytes for safety (APA 2024; CANMAT/ISBD 2018)
- tshrequiredlab • used at INITIAL_WORKUPHypothyroidism from lithium; thyroid dysfunction mimics mood episodes (APA 2024)
- cbcrequiredlab • used at INITIAL_WORKUPBaseline for valproate (thrombocytopenia) and carbamazepine (agranulocytosis) (APA 2024; CANMAT/ISBD 2018)
- lftrequiredlab • used at INITIAL_WORKUPHepatotoxicity monitoring for valproate (APA 2024; CANMAT/ISBD 2018 Yatham)
- lithium_levellab • used at MONITORINGTherapeutic drug monitoring — acute mania 0.8–1.2 mmol/L, maintenance 0.6–0.8 mmol/L (APA 2024; BALANCE Geddes Lancet 2010)
- valproate_levellab • used at MONITORINGTherapeutic 50–125 mcg/mL for acute mania (APA 2024; CANMAT/ISBD 2018)
- glucose_a1c_lipidlab • used at INITIAL_WORKUPMetabolic baseline before SGA initiation — APA/ADA 2004 consensus; CANMAT/ISBD 2018
- pregnancy_testrequiredlab • used at INITIAL_WORKUPValproate absolute contraindication in pregnancy (FDA 2013 black-box); lithium shared decision-making (APA 2024)
- ecgimaging • used at INITIAL_WORKUPQTc baseline before SGA especially ziprasidone (FDA; APA 2024); lithium T-wave changes (APA 2024)
12-phase flow (12)
- 1FRAMEConfirm DSM-5-TR 2022 bipolar I or II diagnosis — at least one manic (BP I) or hypomanic (BP II) episode; identify current episode polarity (manic, depressive, mixed, or euthymic maintenance) (APA 2024)advance: Bipolar diagnosis confirmed with polarity and subtype specified (DSM-5-TR 2022; APA 2024)
- 2ENTRYTrigger from acute mania/hypomania presentation, bipolar depression, mixed features, rapid cycling, antidepressant-induced switch, or maintenance breakthrough (APA 2024; CANMAT/ISBD 2018 Yatham)inputs: age, ymrs_scoreadvance: Entry criteria documented with current episode polarity (APA 2024)
- 3CONTEXTPrior mood episodes and polarity pattern, prior mood stabiliser / SGA response and tolerability, substance use, medical comorbidity (renal/hepatic/metabolic), current medications, pregnancy status, family history (APA 2024; CANMAT/ISBD 2018 Yatham)inputs: mood_episode_history, prior_mood_stabiliser_response, substance_use, medical_comorbidity, current_meds, sex_and_pregnancy_statusadvance: Personalisation data captured (APA 2024)
- 4RED_FLAGSActive suicidality (C-SSRS; bipolar suicide risk 20–30× population — Pompili Bipolar Disord 2013); psychotic mania with dangerous behaviour; catatonia (Bush-Francis screen); severe agitation with violence risk; lithium toxicity; neuroleptic malignant syndrome; pregnancy on valproate (APA 2024)inputs: suicidality_assessmentactions: workup.suicide_risk, workup.acute_psychosis, workup.deliriumadvance: Safety plan in place OR involuntary admission initiated (APA 2024; CANMAT/ISBD 2018)
- 5INITIAL_WORKUPBMP (renal for lithium), TSH, CBC (valproate/carbamazepine), LFTs (valproate), pregnancy test, fasting glucose/A1c/lipids if SGA planned (APA/ADA 2004), ECG if QTc-prolonging agent (APA 2024; CANMAT/ISBD 2018 Yatham)inputs: bmp, tsh, cbc, lft, pregnancy_testadvance: Baseline labs returned (APA 2024)
- 6BRANCHING_WORKUPUrine drug screen if substance-induced mania suspected; neuroimaging if first episode >40 yr or focal findings; sleep study if sleep deprivation a trigger; B12/folate/RPR in late-onset mania; EEG if seizures suspected with valproate (APA 2024; CANMAT/ISBD 2018)advance: Targeted workup obtained when triggered (APA 2024)
- 7DIFFERENTIALBipolar I vs II vs cyclothymia vs schizoaffective vs substance-induced mania vs hyperthyroidism vs steroid-induced mania vs ADHD vs borderline personality disorder vs MDD with mixed features (DSM-5-TR 2022; APA 2024)advance: Working diagnosis assigned with subtype and current polarity (APA 2024)
- 8RISK_STRATIFICATIONYMRS severity for mania (mild <20, moderate 20–30, severe >30; Young 1978); PHQ-9/MADRS for bipolar depression; C-SSRS for suicide risk; rapid-cycling status; mixed-features specifier; psychotic features; functional impairment (APA 2024; CANMAT/ISBD 2018 Yatham)inputs: ymrs_score, suicidality_assessmentadvance: Severity tier + polarity + safety plan documented (APA 2024)
- 9TREATMENTAcute mania: lithium or valproate + SGA (APA 2024; CANMAT/ISBD 2018); bipolar depression: quetiapine or lurasidone or cariprazine or lamotrigine — AVOID antidepressant monotherapy (STEP-BD Sachs NEJM 2007; APA 2024); mixed features: valproate or SGA preferred over lithium (CANMAT/ISBD 2018); rapid cycling: optimise mood stabiliser, avoid antidepressants (APA 2024); maintenance: lithium preferred per BALANCE (Geddes Lancet 2010)inputs: current_medsadvance: Regimen selected matching polarity + severity + safety (APA 2024)
- 10DISPOSITIONAcute severe mania or psychotic mania → inpatient psychiatry; moderate mania with intact judgement → partial hospitalisation or IOP; bipolar depression with SI → inpatient; euthymic maintenance → outpatient; involuntary hold if danger to self/others or grave disability (APA 2024; CANMAT/ISBD 2018)advance: Level of care set (APA 2024)
- 11MONITORINGAcute mania: YMRS at days 3, 7, 14, 21 (APA 2024); lithium level q5–7 d during titration then q3–6 mo (APA 2024); valproate level at day 5 then q3–6 mo; renal + TSH q6 mo on lithium; CBC + LFT q6 mo on valproate; SGA metabolic panel baseline/3 mo/6 mo/annual (APA/ADA 2004); bipolar depression: PHQ-9/MADRS q2–4 weeks (APA 2024)advance: Response (50% YMRS reduction) or remission OR step-up (APA 2024)
- 12FOLLOWUPLifelong maintenance recommended for BP I after single manic episode (APA 2024; BALANCE Geddes Lancet 2010); lithium preferred — 30% relapse reduction vs valproate alone (BALANCE Geddes Lancet 2010); psychoeducation + sleep hygiene + circadian rhythm stabilisation (Frank Int J Bipolar Disord 2015); relapse prevention CBT/IPSRT reduces relapse (Miklowitz JAMA Psych 2007); lifestyle (exercise, alcohol avoidance, social rhythm) (APA 2024; NICE 2024)advance: Maintenance plan in place with lifelong mood stabiliser (APA 2024)