Clinical Commander

All dossiers
psych.bipolar-disorder.core.v1

Bipolar Disorder — acute mania + bipolar depression + maintenance (APA 2024; CANMAT/ISBD 2018; BALANCE Geddes Lancet 2010)

psychiatryacutechronicadultacuteinpatientoutpatient

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)

  • symptom
    Elevated/expansive/irritable mood + increased energy ≥1 week (mania) or ≥4 days (hypomania) (DSM-5-TR 2022 criterion A)
    acute_mania_hypomania
  • symptom
    Major depressive episode in patient with prior mania or hypomania (DSM-5-TR 2022; APA 2024)
    bipolar_depressive_episode
  • symptom
    Manic or depressive episode with ≥3 features of opposite polarity (DSM-5-TR 2022 mixed-features specifier)
    mixed_features
  • symptom
    Grandiose 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_list
    Known bipolar disorder with breakthrough mania, hypomania, depression, or mixed state (APA 2024)
    known_bipolar_relapse
  • history
    Manic or hypomanic switch during antidepressant treatment (APA 2024; STEP-BD Sachs NEJM 2007)
    antidepressant_induced_mania

Required inputs (19)

  • agerequired
    demographic • used at CONTEXT
    Drug selection and dose adjustment; adolescent vs adult vs geriatric (APA 2024; CANMAT/ISBD 2018 Yatham)
  • sex_and_pregnancy_statusrequired
    demographic • used at CONTEXT
    Valproate contraindicated in pregnancy (FDA 2013 black-box); lithium Ebstein risk low but requires shared decision-making (APA 2024; CANMAT/ISBD 2018)
  • ymrs_scorerequired
    symptom • used at RISK_STRATIFICATION
    Young Mania Rating Scale stratifies acute mania severity and tracks response (YMRS Young 1978; APA 2024)
  • phq9_or_madrs_score
    symptom • used at RISK_STRATIFICATION
    PHQ-9 or MADRS stratifies bipolar depression severity (APA 2024; CANMAT/ISBD 2018 Yatham)
  • suicidality_assessmentrequired
    symptom • used at RED_FLAGS
    C-SSRS — bipolar carries 20–30× population suicide risk (Pompili Bipolar Disord 2013; APA 2024)
  • mood_episode_historyrequired
    history • used at CONTEXT
    Number, polarity, and timing of prior episodes — determines BP I vs BP II, rapid cycling (DSM-5-TR 2022; APA 2024)
  • prior_mood_stabiliser_responserequired
    history • used at CONTEXT
    Prior lithium / valproate / lamotrigine / SGA response guides re-selection (APA 2024; CANMAT/ISBD 2018 Yatham)
  • substance_userequired
    history • used at CONTEXT
    Comorbid SUD in >40% of bipolar — worsens course, affects drug choice (APA 2024; CANMAT/ISBD 2018)
  • medical_comorbidityrequired
    history • used at CONTEXT
    Renal disease affects lithium; hepatic disease affects valproate; metabolic syndrome affects SGA choice (APA 2024; CANMAT/ISBD 2018 Yatham)
  • current_medsrequired
    medication • used at CONTEXT
    Identify current mood stabilisers, antidepressants (discontinue if manic switch), CYP interactions, QTc load (APA 2024)
  • bmprequired
    lab • used at INITIAL_WORKUP
    Baseline renal function for lithium; electrolytes for safety (APA 2024; CANMAT/ISBD 2018)
  • tshrequired
    lab • used at INITIAL_WORKUP
    Hypothyroidism from lithium; thyroid dysfunction mimics mood episodes (APA 2024)
  • cbcrequired
    lab • used at INITIAL_WORKUP
    Baseline for valproate (thrombocytopenia) and carbamazepine (agranulocytosis) (APA 2024; CANMAT/ISBD 2018)
  • lftrequired
    lab • used at INITIAL_WORKUP
    Hepatotoxicity monitoring for valproate (APA 2024; CANMAT/ISBD 2018 Yatham)
  • lithium_level
    lab • used at MONITORING
    Therapeutic drug monitoring — acute mania 0.8–1.2 mmol/L, maintenance 0.6–0.8 mmol/L (APA 2024; BALANCE Geddes Lancet 2010)
  • valproate_level
    lab • used at MONITORING
    Therapeutic 50–125 mcg/mL for acute mania (APA 2024; CANMAT/ISBD 2018)
  • glucose_a1c_lipid
    lab • used at INITIAL_WORKUP
    Metabolic baseline before SGA initiation — APA/ADA 2004 consensus; CANMAT/ISBD 2018
  • pregnancy_testrequired
    lab • used at INITIAL_WORKUP
    Valproate absolute contraindication in pregnancy (FDA 2013 black-box); lithium shared decision-making (APA 2024)
  • ecg
    imaging • used at INITIAL_WORKUP
    QTc baseline before SGA especially ziprasidone (FDA; APA 2024); lithium T-wave changes (APA 2024)

12-phase flow (12)

  1. 1FRAME
    Confirm 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)
  2. 2ENTRY
    Trigger 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_score
    advance: Entry criteria documented with current episode polarity (APA 2024)
  3. 3CONTEXT
    Prior 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_status
    advance: Personalisation data captured (APA 2024)
  4. 4RED_FLAGS
    Active 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_assessment
    actions: workup.suicide_risk, workup.acute_psychosis, workup.delirium
    advance: Safety plan in place OR involuntary admission initiated (APA 2024; CANMAT/ISBD 2018)
  5. 5INITIAL_WORKUP
    BMP (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_test
    advance: Baseline labs returned (APA 2024)
  6. 6BRANCHING_WORKUP
    Urine 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)
  7. 7DIFFERENTIAL
    Bipolar 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)
  8. 8RISK_STRATIFICATION
    YMRS 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_assessment
    advance: Severity tier + polarity + safety plan documented (APA 2024)
  9. 9TREATMENT
    Acute 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_meds
    advance: Regimen selected matching polarity + severity + safety (APA 2024)
  10. 10DISPOSITION
    Acute 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)
  11. 11MONITORING
    Acute 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)
  12. 12FOLLOWUP
    Lifelong 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)