
Clinical Decision Support
- 854 installs
- 32k repo stars
- Updated July 29, 2026
- k-dense-ai/scientific-agent-skills
clinical-decision-support is a Claude Code skill that generates structured genomic and clinical profile reports with tiered evidence and variant sections for decision-support workflows.
About
clinical-decision-support is a Claude Code skill from k-dense-ai scientific-agent-skills that produces structured genomic and clinical profile reports for decision-support pipelines. The skill uses a LaTeX article template with tiered evidence color coding across three tiers, plus dedicated sections for mutations, amplifications, and fusions. Reports render in a 10pt letterpaper layout with tabular variant data, booktabs tables, and color-coded tcolorbox callouts for evidence strength. Developers reach for clinical-decision-support when building health-informatics agents that must output clinician-readable genomic profiles with graded evidence rather than raw variant VCF dumps.
- LaTeX genomic profile report scaffold with patient ID header and pagination
- Color-coded tier semantics (tier1/tier2/tier3) for evidence or action levels
- Variant class styling for mutation, amplification, and fusion callouts
- Compact clinical one-page oriented layout (letter, 0.5in margins)
- Agent-oriented scientific skill packaging for CDS-style deliverables
Clinical Decision Support by the numbers
- 854 all-time installs (skills.sh)
- +41 installs in the week ending Jul 29, 2026 (Skillselion tracking)
- Ranked #1,229 of 16,570 AI & Agent Building skills by installs in the Skillselion catalog
- Security screen: CRITICAL risk (skills.sh audit)
- Data as of Jul 29, 2026 (Skillselion catalog sync)
npx skills add https://github.com/k-dense-ai/scientific-agent-skills --skill clinical-decision-supportAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 854 |
|---|---|
| repo stars | ★ 32k |
| Security audit | 2 / 3 scanners passed |
| Last updated | July 29, 2026 |
| Repository | k-dense-ai/scientific-agent-skills ↗ |
How do you generate tiered clinical genomic reports?
Generate structured genomic/clinical profile reports with tiered evidence and variant sections for decision-support workflows.
Who is it for?
Health-informatics developers building genomic decision-support agents that need structured, evidence-tiered clinical reports.
Skip if: General medical diagnosis chatbots, non-genomic clinical notes, or teams without variant-annotation data pipelines.
When should I use this skill?
The user asks to generate a clinical decision-support report, genomic profile, or tiered evidence variant summary.
What you get
LaTeX clinical profile report, tiered evidence sections, and variant annotation tables
- LaTeX clinical profile report
- Tiered evidence summary
- Variant annotation tables
By the numbers
- Report template uses 3 tiered evidence levels with distinct color coding
- LaTeX layout targets 10pt letterpaper with 0.5in margins
Files
Clinical Decision Support Documents
Description
Generate professional clinical decision support (CDS) documents for pharmaceutical companies, clinical researchers, and medical decision-makers. This skill specializes in analytical, evidence-based documents that inform treatment strategies and drug development:
1. Patient Cohort Analysis - Biomarker-stratified group analyses with statistical outcome comparisons 2. Treatment Recommendation Reports - Evidence-based clinical guidelines with GRADE grading and decision algorithms
All documents are generated as publication-ready LaTeX/PDF files optimized for pharmaceutical research, regulatory submissions, and clinical guideline development.
Note: For individual patient treatment plans at the bedside, use the treatment-plans skill instead. This skill focuses on group-level analyses and evidence synthesis for pharmaceutical/research settings.
Writing Style: For publication-ready documents targeting medical journals, consult the venue-templates skill's medical_journal_styles.md for guidance on structured abstracts, evidence language, and CONSORT/STROBE compliance.
Capabilities
Document Types
Patient Cohort Analysis
- Biomarker-based patient stratification (molecular subtypes, gene expression, IHC)
- Molecular subtype classification (e.g., GBM mesenchymal-immune-active vs proneural, breast cancer subtypes)
- Outcome metrics with statistical analysis (OS, PFS, ORR, DOR, DCR)
- Statistical comparisons between subgroups (hazard ratios, p-values, 95% CI)
- Survival analysis with Kaplan-Meier curves and log-rank tests
- Efficacy tables and waterfall plots
- Comparative effectiveness analyses
- Pharmaceutical cohort reporting (trial subgroups, real-world evidence)
Treatment Recommendation Reports
- Evidence-based treatment guidelines for specific disease states
- Strength of recommendation grading (GRADE system: 1A, 1B, 2A, 2B, 2C)
- Quality of evidence assessment (high, moderate, low, very low)
- Treatment algorithm flowcharts with TikZ diagrams
- Line-of-therapy sequencing based on biomarkers
- Decision pathways with clinical and molecular criteria
- Pharmaceutical strategy documents
- Clinical guideline development for medical societies
Clinical Features
- Biomarker Integration: Genomic alterations (mutations, CNV, fusions), gene expression signatures, IHC markers, PD-L1 scoring
- Statistical Analysis: Hazard ratios, p-values, confidence intervals, survival curves, Cox regression, log-rank tests
- Evidence Grading: GRADE system (1A/1B/2A/2B/2C), Oxford CEBM levels, quality of evidence assessment
- Clinical Terminology: SNOMED-CT, LOINC, proper medical nomenclature, trial nomenclature
- Regulatory Compliance: HIPAA de-identification, confidentiality headers, ICH-GCP alignment
- Professional Formatting: Compact 0.5in margins, color-coded recommendations, publication-ready, suitable for regulatory submissions
Pharmaceutical and Research Use Cases
This skill is specifically designed for pharmaceutical and clinical research applications:
Drug Development
- Phase 2/3 Trial Analyses: Biomarker-stratified efficacy and safety analyses
- Subgroup Analyses: Forest plots showing treatment effects across patient subgroups
- Companion Diagnostic Development: Linking biomarkers to drug response
- Regulatory Submissions: IND/NDA documentation with evidence summaries
Medical Affairs
- KOL Education Materials: Evidence-based treatment algorithms for thought leaders
- Medical Strategy Documents: Competitive landscape and positioning strategies
- Advisory Board Materials: Cohort analyses and treatment recommendation frameworks
- Publication Planning: Manuscript-ready analyses for peer-reviewed journals
Clinical Guidelines
- Guideline Development: Evidence synthesis with GRADE methodology for specialty societies
- Consensus Recommendations: Multi-stakeholder treatment algorithm development
- Practice Standards: Biomarker-based treatment selection criteria
- Quality Measures: Evidence-based performance metrics
Real-World Evidence
- RWE Cohort Studies: Retrospective analyses of patient cohorts from EMR data
- Comparative Effectiveness: Head-to-head treatment comparisons in real-world settings
- Outcomes Research: Long-term survival and safety in clinical practice
- Health Economics: Cost-effectiveness analyses by biomarker subgroup
When to Use
Use this skill when you need to:
- Analyze patient cohorts stratified by biomarkers, molecular subtypes, or clinical characteristics
- Generate treatment recommendation reports with evidence grading for clinical guidelines or pharmaceutical strategies
- Compare outcomes between patient subgroups with statistical analysis (survival, response rates, hazard ratios)
- Produce pharmaceutical research documents for drug development, clinical trials, or regulatory submissions
- Develop clinical practice guidelines with GRADE evidence grading and decision algorithms
- Document biomarker-guided therapy selection at the population level (not individual patients)
- Synthesize evidence from multiple trials or real-world data sources
- Create clinical decision algorithms with flowcharts for treatment sequencing
Do NOT use this skill for:
- Individual patient treatment plans (use
treatment-plansskill) - Bedside clinical care documentation (use
treatment-plansskill) - Simple patient-specific treatment protocols (use
treatment-plansskill)
Visual Enhancement with Scientific Schematics
⚠️ MANDATORY: Every clinical decision support document MUST include at least 1-2 AI-generated figures using the scientific-schematics skill.
This is not optional. Clinical decision documents require clear visual algorithms. Before finalizing any document: 1. Generate at minimum ONE schematic or diagram (e.g., clinical decision algorithm, treatment pathway, or biomarker stratification tree) 2. For cohort analyses: include patient flow diagram 3. For treatment recommendations: include decision flowchart
How to generate figures:
- Use the scientific-schematics skill to generate AI-powered publication-quality diagrams
- Simply describe your desired diagram in natural language
- Nano Banana Pro will automatically generate, review, and refine the schematic
How to generate schematics:
python scripts/generate_schematic.py "your diagram description" -o figures/output.pngThe AI will automatically:
- Create publication-quality images with proper formatting
- Review and refine through multiple iterations
- Ensure accessibility (colorblind-friendly, high contrast)
- Save outputs in the figures/ directory
When to add schematics:
- Clinical decision algorithm flowcharts
- Treatment pathway diagrams
- Biomarker stratification trees
- Patient cohort flow diagrams (CONSORT-style)
- Survival curve visualizations
- Molecular mechanism diagrams
- Any complex concept that benefits from visualization
For detailed guidance on creating schematics, refer to the scientific-schematics skill documentation.
---
Document Structure
CRITICAL REQUIREMENT: All clinical decision support documents MUST begin with a complete executive summary on page 1 that spans the entire first page before any table of contents or detailed sections.
Page 1 Executive Summary Structure
The first page of every CDS document should contain ONLY the executive summary with the following components:
Required Elements (all on page 1): 1. Document Title and Type
- Main title (e.g., "Biomarker-Stratified Cohort Analysis" or "Evidence-Based Treatment Recommendations")
- Subtitle with disease state and focus
2. Report Information Box (using colored tcolorbox)
- Document type and purpose
- Date of analysis/report
- Disease state and patient population
- Author/institution (if applicable)
- Analysis framework or methodology
3. Key Findings Boxes (3-5 colored boxes using tcolorbox)
- Primary Results (blue box): Main efficacy/outcome findings
- Biomarker Insights (green box): Key molecular subtype findings
- Clinical Implications (yellow/orange box): Actionable treatment implications
- Statistical Summary (gray box): Hazard ratios, p-values, key statistics
- Safety Highlights (red box, if applicable): Critical adverse events or warnings
Visual Requirements:
- Use
\thispagestyle{empty}to remove page numbers from page 1 - All content must fit on page 1 (before
\newpage) - Use colored tcolorbox environments with different colors for visual hierarchy
- Boxes should be scannable and highlight most critical information
- Use bullet points, not narrative paragraphs
- End page 1 with
\newpagebefore table of contents or detailed sections
Example First Page LaTeX Structure:
\maketitle
\thispagestyle{empty}
% Report Information Box
\begin{tcolorbox}[colback=blue!5!white, colframe=blue!75!black, title=Report Information]
\textbf{Document Type:} Patient Cohort Analysis\\
\textbf{Disease State:} HER2-Positive Metastatic Breast Cancer\\
\textbf{Analysis Date:} \today\\
\textbf{Population:} 60 patients, biomarker-stratified by HR status
\end{tcolorbox}
\vspace{0.3cm}
% Key Finding #1: Primary Results
\begin{tcolorbox}[colback=blue!5!white, colframe=blue!75!black, title=Primary Efficacy Results]
\begin{itemize}
\item Overall ORR: 72\% (95\% CI: 59-83\%)
\item Median PFS: 18.5 months (95\% CI: 14.2-22.8)
\item Median OS: 35.2 months (95\% CI: 28.1-NR)
\end{itemize}
\end{tcolorbox}
\vspace{0.3cm}
% Key Finding #2: Biomarker Insights
\begin{tcolorbox}[colback=green!5!white, colframe=green!75!black, title=Biomarker Stratification Findings]
\begin{itemize}
\item HR+/HER2+: ORR 68\%, median PFS 16.2 months
\item HR-/HER2+: ORR 78\%, median PFS 22.1 months
\item HR status significantly associated with outcomes (p=0.041)
\end{itemize}
\end{tcolorbox}
\vspace{0.3cm}
% Key Finding #3: Clinical Implications
\begin{tcolorbox}[colback=orange!5!white, colframe=orange!75!black, title=Clinical Recommendations]
\begin{itemize}
\item Strong efficacy observed regardless of HR status (Grade 1A)
\item HR-/HER2+ patients showed numerically superior outcomes
\item Treatment recommended for all HER2+ MBC patients
\end{itemize}
\end{tcolorbox}
\newpage
\tableofcontents % TOC on page 2
\newpage % Detailed content starts page 3Patient Cohort Analysis (Detailed Sections - Page 3+)
- Cohort Characteristics: Demographics, baseline features, patient selection criteria
- Biomarker Stratification: Molecular subtypes, genomic alterations, IHC profiles
- Treatment Exposure: Therapies received, dosing, treatment duration by subgroup
- Outcome Analysis: Response rates (ORR, DCR), survival data (OS, PFS), DOR
- Statistical Methods: Kaplan-Meier survival curves, hazard ratios, log-rank tests, Cox regression
- Subgroup Comparisons: Biomarker-stratified efficacy, forest plots, statistical significance
- Safety Profile: Adverse events by subgroup, dose modifications, discontinuations
- Clinical Recommendations: Treatment implications based on biomarker profiles
- Figures: Waterfall plots, swimmer plots, survival curves, forest plots
- Tables: Demographics table, biomarker frequency, outcomes by subgroup
Treatment Recommendation Reports (Detailed Sections - Page 3+)
Page 1 Executive Summary for Treatment Recommendations should include: 1. Report Information Box: Disease state, guideline version/date, target population 2. Key Recommendations Box (green): Top 3-5 GRADE-graded recommendations by line of therapy 3. Biomarker Decision Criteria Box (blue): Key molecular markers influencing treatment selection 4. Evidence Summary Box (gray): Major trials supporting recommendations (e.g., KEYNOTE-189, FLAURA) 5. Critical Monitoring Box (orange/red): Essential safety monitoring requirements
Detailed Sections (Page 3+):
- Clinical Context: Disease state, epidemiology, current treatment landscape
- Target Population: Patient characteristics, biomarker criteria, staging
- Evidence Review: Systematic literature synthesis, guideline summary, trial data
- Treatment Options: Available therapies with mechanism of action
- Evidence Grading: GRADE assessment for each recommendation (1A, 1B, 2A, 2B, 2C)
- Recommendations by Line: First-line, second-line, subsequent therapies
- Biomarker-Guided Selection: Decision criteria based on molecular profiles
- Treatment Algorithms: TikZ flowcharts showing decision pathways
- Monitoring Protocol: Safety assessments, efficacy monitoring, dose modifications
- Special Populations: Elderly, renal/hepatic impairment, comorbidities
- References: Full bibliography with trial names and citations
Output Format
MANDATORY FIRST PAGE REQUIREMENT:
- Page 1: Full-page executive summary with 3-5 colored tcolorbox elements
- Page 2: Table of contents (optional)
- Page 3+: Detailed sections with methods, results, figures, tables
Document Specifications:
- Primary: LaTeX/PDF with 0.5in margins for compact, data-dense presentation
- Length: Typically 5-15 pages (1 page executive summary + 4-14 pages detailed content)
- Style: Publication-ready, pharmaceutical-grade, suitable for regulatory submissions
- First Page: Always a complete executive summary spanning entire page 1 (see Document Structure section)
Visual Elements:
- Colors:
- Page 1 boxes: blue=data/information, green=biomarkers/recommendations, yellow/orange=clinical implications, red=warnings
- Recommendation boxes (green=strong recommendation, yellow=conditional, blue=research needed)
- Biomarker stratification (color-coded molecular subtypes)
- Statistical significance (color-coded p-values, hazard ratios)
- Tables:
- Demographics with baseline characteristics
- Biomarker frequency by subgroup
- Outcomes table (ORR, PFS, OS, DOR by molecular subtype)
- Adverse events by cohort
- Evidence summary tables with GRADE ratings
- Figures:
- Kaplan-Meier survival curves with log-rank p-values and number at risk tables
- Waterfall plots showing best response by patient
- Forest plots for subgroup analyses with confidence intervals
- TikZ decision algorithm flowcharts
- Swimmer plots for individual patient timelines
- Statistics: Hazard ratios with 95% CI, p-values, median survival times, landmark survival rates
- Compliance: De-identification per HIPAA Safe Harbor, confidentiality notices for proprietary data
Integration
This skill integrates with:
- scientific-writing: Citation management, statistical reporting, evidence synthesis
- clinical-reports: Medical terminology, HIPAA compliance, regulatory documentation
- scientific-schematics: TikZ flowcharts for decision algorithms and treatment pathways
- treatment-plans: Individual patient applications of cohort-derived insights (bidirectional)
Key Differentiators from Treatment-Plans Skill
Clinical Decision Support (this skill):
- Audience: Pharmaceutical companies, clinical researchers, guideline committees, medical affairs
- Scope: Population-level analyses, evidence synthesis, guideline development
- Focus: Biomarker stratification, statistical comparisons, evidence grading
- Output: Multi-page analytical documents (5-15 pages typical) with extensive figures and tables
- Use Cases: Drug development, regulatory submissions, clinical practice guidelines, medical strategy
- Example: "Analyze 60 HER2+ breast cancer patients by hormone receptor status with survival outcomes"
Treatment-Plans Skill:
- Audience: Clinicians, patients, care teams
- Scope: Individual patient care planning
- Focus: SMART goals, patient-specific interventions, monitoring plans
- Output: Concise 1-4 page actionable care plans
- Use Cases: Bedside clinical care, EMR documentation, patient-centered planning
- Example: "Create treatment plan for a 55-year-old patient with newly diagnosed type 2 diabetes"
When to use each:
- Use clinical-decision-support for: cohort analyses, biomarker stratification studies, treatment guideline development, pharmaceutical strategy documents
- Use treatment-plans for: individual patient care plans, treatment protocols for specific patients, bedside clinical documentation
Example Usage
Patient Cohort Analysis
Example 1: NSCLC Biomarker Stratification
> Analyze a cohort of 45 NSCLC patients stratified by PD-L1 expression (<1%, 1-49%, ≥50%)
> receiving pembrolizumab. Include outcomes: ORR, median PFS, median OS with hazard ratios
> comparing PD-L1 ≥50% vs <50%. Generate Kaplan-Meier curves and waterfall plot.Example 2: GBM Molecular Subtype Analysis
> Generate cohort analysis for 30 GBM patients classified into Cluster 1 (Mesenchymal-Immune-Active)
> and Cluster 2 (Proneural) molecular subtypes. Compare outcomes including median OS, 6-month PFS rate,
> and response to TMZ+bevacizumab. Include biomarker profile table and statistical comparison.Example 3: Breast Cancer HER2 Cohort
> Analyze 60 HER2-positive metastatic breast cancer patients treated with trastuzumab-deruxtecan,
> stratified by prior trastuzumab exposure (yes/no). Include ORR, DOR, median PFS with forest plot
> showing subgroup analyses by hormone receptor status, brain metastases, and number of prior lines.Treatment Recommendation Report
Example 1: HER2+ Metastatic Breast Cancer Guidelines
> Create evidence-based treatment recommendations for HER2-positive metastatic breast cancer including
> biomarker-guided therapy selection. Use GRADE system to grade recommendations for first-line
> (trastuzumab+pertuzumab+taxane), second-line (trastuzumab-deruxtecan), and third-line options.
> Include decision algorithm flowchart based on brain metastases, hormone receptor status, and prior therapies.Example 2: Advanced NSCLC Treatment Algorithm
> Generate treatment recommendation report for advanced NSCLC based on PD-L1 expression, EGFR mutation,
> ALK rearrangement, and performance status. Include GRADE-graded recommendations for each molecular subtype,
> TikZ flowchart for biomarker-directed therapy selection, and evidence tables from KEYNOTE-189, FLAURA,
> and CheckMate-227 trials.Example 3: Multiple Myeloma Line-of-Therapy Sequencing
> Create treatment algorithm for newly diagnosed multiple myeloma through relapsed/refractory setting.
> Include GRADE recommendations for transplant-eligible vs ineligible, high-risk cytogenetics considerations,
> and sequencing of daratumumab, carfilzomib, and CAR-T therapy. Provide flowchart showing decision points
> at each line of therapy.Key Features
Biomarker Classification
- Genomic: Mutations, CNV, gene fusions
- Expression: RNA-seq, IHC scores
- Molecular subtypes: Disease-specific classifications
- Clinical actionability: Therapy selection guidance
Outcome Metrics
- Survival: OS (overall survival), PFS (progression-free survival)
- Response: ORR (objective response rate), DOR (duration of response), DCR (disease control rate)
- Quality: ECOG performance status, symptom burden
- Safety: Adverse events, dose modifications
Statistical Methods
- Survival analysis: Kaplan-Meier curves, log-rank tests
- Group comparisons: t-tests, chi-square, Fisher's exact
- Effect sizes: Hazard ratios, odds ratios with 95% CI
- Significance: p-values, multiple testing corrections
Evidence Grading
GRADE System
- 1A: Strong recommendation, high-quality evidence
- 1B: Strong recommendation, moderate-quality evidence
- 2A: Weak recommendation, high-quality evidence
- 2B: Weak recommendation, moderate-quality evidence
- 2C: Weak recommendation, low-quality evidence
Recommendation Strength
- Strong: Benefits clearly outweigh risks
- Conditional: Trade-offs exist, patient values important
- Research: Insufficient evidence, clinical trials needed
Best Practices
For Cohort Analyses
1. Patient Selection Transparency: Clearly document inclusion/exclusion criteria, patient flow, and reasons for exclusions 2. Biomarker Clarity: Specify assay methods, platforms (e.g., FoundationOne, Caris), cut-points, and validation status 3. Statistical Rigor:
- Report hazard ratios with 95% confidence intervals, not just p-values
- Include median follow-up time for survival analyses
- Specify statistical tests used (log-rank, Cox regression, Fisher's exact)
- Account for multiple comparisons when appropriate
4. Outcome Definitions: Use standard criteria:
- Response: RECIST 1.1, iRECIST for immunotherapy
- Adverse events: CTCAE version 5.0
- Performance status: ECOG or Karnofsky
5. Survival Data Presentation:
- Median OS/PFS with 95% CI
- Landmark survival rates (6-month, 12-month, 24-month)
- Number at risk tables below Kaplan-Meier curves
- Censoring clearly indicated
6. Subgroup Analyses: Pre-specify subgroups; clearly label exploratory vs pre-planned analyses 7. Data Completeness: Report missing data and how it was handled
For Treatment Recommendation Reports
1. Evidence Grading Transparency:
- Use GRADE system consistently (1A, 1B, 2A, 2B, 2C)
- Document rationale for each grade
- Clearly state quality of evidence (high, moderate, low, very low)
2. Comprehensive Evidence Review:
- Include phase 3 randomized trials as primary evidence
- Supplement with phase 2 data for emerging therapies
- Note real-world evidence and meta-analyses
- Cite trial names (e.g., KEYNOTE-189, CheckMate-227)
3. Biomarker-Guided Recommendations:
- Link specific biomarkers to therapy recommendations
- Specify testing methods and validated assays
- Include FDA/EMA approval status for companion diagnostics
4. Clinical Actionability: Every recommendation should have clear implementation guidance 5. Decision Algorithm Clarity: TikZ flowcharts should be unambiguous with clear yes/no decision points 6. Special Populations: Address elderly, renal/hepatic impairment, pregnancy, drug interactions 7. Monitoring Guidance: Specify safety labs, imaging, and frequency 8. Update Frequency: Date recommendations and plan for periodic updates
General Best Practices
1. First Page Executive Summary (MANDATORY):
- ALWAYS create a complete executive summary on page 1 that spans the entire first page
- Use 3-5 colored tcolorbox elements to highlight key findings
- No table of contents or detailed sections on page 1
- Use
\thispagestyle{empty}and end with\newpage - This is the single most important page - it should be scannable in 60 seconds
2. De-identification: Remove all 18 HIPAA identifiers before document generation (Safe Harbor method) 3. Regulatory Compliance: Include confidentiality notices for proprietary pharmaceutical data 4. Publication-Ready Formatting: Use 0.5in margins, professional fonts, color-coded sections 5. Reproducibility: Document all statistical methods to enable replication 6. Conflict of Interest: Disclose pharmaceutical funding or relationships when applicable 7. Visual Hierarchy: Use colored boxes consistently (blue=data, green=biomarkers, yellow/orange=recommendations, red=warnings)
References
See the references/ directory for detailed guidance on:
- Patient cohort analysis and stratification methods
- Treatment recommendation development
- Clinical decision algorithms
- Biomarker classification and interpretation
- Outcome analysis and statistical methods
- Evidence synthesis and grading systems
Templates
See the assets/ directory for LaTeX templates:
cohort_analysis_template.tex- Biomarker-stratified patient cohort analysis with statistical comparisonstreatment_recommendation_template.tex- Evidence-based clinical practice guidelines with GRADE gradingclinical_pathway_template.tex- TikZ decision algorithm flowcharts for treatment sequencingbiomarker_report_template.tex- Molecular subtype classification and genomic profile reports
Template Features:
- 0.5in margins for compact presentation
- Color-coded recommendation boxes
- Professional tables for demographics, biomarkers, outcomes
- Built-in support for Kaplan-Meier curves, waterfall plots, forest plots
- GRADE evidence grading tables
- Confidentiality headers for pharmaceutical documents
Scripts
See the scripts/ directory for analysis and visualization tools:
generate_survival_analysis.py- Kaplan-Meier curve generation with log-rank tests, hazard ratios, 95% CIcreate_waterfall_plot.py- Best response visualization for cohort analysescreate_forest_plot.py- Subgroup analysis visualization with confidence intervalscreate_cohort_tables.py- Demographics, biomarker frequency, and outcomes tablesbuild_decision_tree.py- TikZ flowchart generation for treatment algorithmsbiomarker_classifier.py- Patient stratification algorithms by molecular subtypecalculate_statistics.py- Hazard ratios, Cox regression, log-rank tests, Fisher's exactvalidate_cds_document.py- Quality and compliance checks (HIPAA, statistical reporting standards)grade_evidence.py- Automated GRADE assessment helper for treatment recommendations
\documentclass[10pt,letterpaper]{article}
% Packages
\usepackage[margin=0.5in]{geometry}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{helvet}
\renewcommand{\familydefault}{\sfdefault}
\usepackage{xcolor}
\usepackage{tcolorbox}
\usepackage{array}
\usepackage{tabularx}
\usepackage{booktabs}
\usepackage{enumitem}
\usepackage{titlesec}
\usepackage{fancyhdr}
\usepackage{graphicx}
% Color definitions
\definecolor{headerblue}{RGB}{0,102,204}
\definecolor{tier1green}{RGB}{0,153,76}
\definecolor{tier2orange}{RGB}{255,152,0}
\definecolor{tier3gray}{RGB}{158,158,158}
\definecolor{mutationred}{RGB}{244,67,54}
\definecolor{amplificationblue}{RGB}{33,150,243}
\definecolor{fusionpurple}{RGB}{156,39,176}
\definecolor{highlightgray}{RGB}{240,240,240}
% Section formatting
\titleformat{\section}{\normalfont\fontsize{11}{12}\bfseries\color{headerblue}}{\thesection}{0.5em}{}
\titlespacing*{\section}{0pt}{4pt}{2pt}
\titleformat{\subsection}{\normalfont\fontsize{10}{11}\bfseries}{\thesubsection}{0.5em}{}
\titlespacing*{\subsection}{0pt}{3pt}{1pt}
% List formatting
\setlist[itemize]{leftmargin=*,itemsep=0pt,parsep=0pt,topsep=1pt}
\setlist[enumerate]{leftmargin=*,itemsep=0pt,parsep=0pt,topsep=1pt}
\setlength{\parindent}{0pt}
\setlength{\parskip}{2pt}
% Header/footer
\pagestyle{fancy}
\fancyhf{}
\fancyhead[L]{\footnotesize \textbf{Genomic Profile Report: [PATIENT ID]}}
\fancyhead[R]{\footnotesize Page \thepage}
\renewcommand{\headrulewidth}{0.5pt}
\fancyfoot[C]{\footnotesize Confidential Laboratory Report - CLIA/CAP Certified}
\begin{document}
% Title block
\begin{center}
{\fontsize{14}{16}\selectfont\bfseries\color{headerblue} COMPREHENSIVE GENOMIC PROFILING REPORT}\\[2pt]
{\fontsize{10}{12}\selectfont [Laboratory Name] | CLIA \#: [Number] | CAP \#: [Number]}
\end{center}
\vspace{2pt}
% Patient/Specimen Information
\begin{tcolorbox}[colback=highlightgray,colframe=black]
\begin{minipage}{0.48\textwidth}
{\small
\textbf{Patient Information}\\
Patient ID: [De-identified ID]\\
Date of Birth: [De-identified/Age only]\\
Sex: [M/F]\\
Ordering Physician: [Name, MD]
}
\end{minipage}
\hfill
\begin{minipage}{0.48\textwidth}
{\small
\textbf{Specimen Information}\\
Specimen Type: [Tissue/Blood/Other]\\
Collection Date: [Date]\\
Received Date: [Date]\\
Report Date: [Date]
}
\end{minipage}
\end{tcolorbox}
\vspace{2pt}
% Diagnosis
\textbf{Diagnosis}: [Cancer type, stage, histology]
\textbf{Testing Performed}: [Assay name - e.g., FoundationOne CDx, NGS Panel]
\vspace{2pt}
% Results Summary Box
\begin{tcolorbox}[enhanced,colback=tier1green!10,colframe=tier1green,
title=\textbf{RESULTS SUMMARY},fonttitle=\bfseries,coltitle=black]
{\small
\textbf{Actionable Findings}: [X] alteration(s) detected
\begin{itemize}
\item \textbf{Tier 1}: [Number] FDA-approved therapy target(s)
\item \textbf{Tier 2}: [Number] clinical trial or off-label option(s)
\item \textbf{Tier 3}: [Number] variant(s) of uncertain significance
\end{itemize}
\textbf{Additional Biomarkers}:
\begin{itemize}
\item Tumor Mutational Burden (TMB): [X.X] mutations/Mb - [High/Intermediate/Low]
\item Microsatellite Status: [MSI-H / MSS / Not assessed]
\item PD-L1 Expression: [X\% TPS / Not assessed]
\end{itemize}
}
\end{tcolorbox}
\section{Tier 1: FDA-Approved Targeted Therapies}
\begin{tcolorbox}[enhanced,colback=tier1green!5,colframe=tier1green,
title={\colorbox{mutationred!60}{\textcolor{white}{\textbf{MUTATION}}} \textbf{[Gene Name] [Alteration]} \hfill \textbf{TIER 1 - ACTIONABLE}},
fonttitle=\bfseries\small,coltitle=black]
{\small
\textbf{Alteration}: [Gene] [Specific variant - e.g., EGFR p.L858R (c.2573T>G)]\\
\textbf{Variant Allele Frequency (VAF)}: XX\% (suggests [clonal/subclonal] mutation)\\
\textbf{Classification}: [Pathogenic / Likely Pathogenic] (ClinVar, OncoKB)
\textbf{Clinical Significance}: \textcolor{tier1green}{\textbf{ACTIONABLE - FDA-APPROVED THERAPY AVAILABLE}}
\textbf{FDA-Approved Therapy}:
\begin{itemize}
\item \textbf{Drug}: [Drug name (brand name)] XX mg [PO/IV] [schedule]
\item \textbf{Indication}: [Specific disease, line of therapy]
\item \textbf{Evidence}: [Pivotal trial] - [Key results with HR, ORR, median survival]
\item \textbf{Guideline}: NCCN Category [1/2A], [ESMO/ASCO recommendation]
\item \textbf{Expected Outcomes}: ORR XX\%, median PFS XX months
\end{itemize}
\textbf{Alternative Therapies}:
\begin{itemize}
\item [Alternative drug] - [Indication, evidence level]
\end{itemize}
\textbf{Recommendation}: \textbf{STRONG} - Consider [drug name] as [first-line/second-line] therapy (GRADE 1A)
}
\end{tcolorbox}
\vspace{3pt}
\begin{tcolorbox}[enhanced,colback=tier1green!5,colframe=tier1green,
title={\colorbox{amplificationblue!60}{\textcolor{white}{\textbf{AMPLIFICATION}}} \textbf{[Gene] Amplification} \hfill \textbf{TIER 1}},
fonttitle=\bfseries\small,coltitle=black]
{\small
\textbf{Alteration}: [Gene name] amplification\\
\textbf{Copy Number}: [X.X] copies per cell (threshold for positivity: ≥[Y])\\
\textbf{Method}: [NGS copy number analysis / FISH]
\textbf{Clinical Significance}: \textcolor{tier1green}{\textbf{ACTIONABLE - COMPANION DIAGNOSTIC}}
\textbf{Therapy Options}: [Similar structure as mutation section]
}
\end{tcolorbox}
\section{Tier 2: Clinical Trial or Guideline-Recommended Off-Label}
\begin{tcolorbox}[enhanced,colback=tier2orange!5,colframe=tier2orange,
title={\colorbox{fusionpurple!60}{\textcolor{white}{\textbf{FUSION}}} \textbf{[Gene] Rearrangement} \hfill \textbf{TIER 2 - INVESTIGATIONAL}},
fonttitle=\bfseries\small,coltitle=black]
{\small
\textbf{Alteration}: [Gene A]-[Gene B] fusion detected\\
\textbf{Method}: [RNA-seq / DNA NGS / FISH]
\textbf{Clinical Significance}: \textcolor{tier2orange}{\textbf{INVESTIGATIONAL - CLINICAL TRIAL PREFERRED}}
\textbf{Treatment Options}:
\begin{itemize}
\item \textbf{Clinical Trial}: [Specific trial or trial search guidance]
\item \textbf{Off-Label Option}: [Drug] - NCCN Category 2A recommendation
\item \textbf{Evidence}: [Phase 2 data, basket trial results, case series]
\end{itemize}
\textbf{Recommendation}: \textbf{CONDITIONAL} - Consider clinical trial enrollment or off-label use after standard therapy (GRADE 2B)
}
\end{tcolorbox}
\section{Tier 3: Variants of Uncertain Significance (VUS)}
\begin{tcolorbox}[colback=tier3gray!10,colframe=tier3gray]
{\small
\textbf{[Gene] [Variant]}: [Description]\\
\textbf{Classification}: Variant of Uncertain Significance (VUS)\\
\textbf{Clinical Actionability}: None currently - insufficient evidence\\
\textbf{Recommendation}: No treatment change based on this finding; may be reclassified as evidence emerges
}
\end{tcolorbox}
\section{Biomarkers Assessed - Negative}
\textbf{No Alterations Detected in}:
\begin{multicols}{3}
\begin{itemize}
\item [Gene 1]
\item [Gene 2]
\item [Gene 3]
\item [Gene 4]
\item [Gene 5]
\item [Gene 6]
\end{itemize}
\end{multicols}
\section{Additional Biomarkers}
\subsection{Tumor Mutational Burden (TMB)}
\textbf{TMB}: [X.X] mutations per megabase
\textbf{Classification}:
\begin{itemize}
\item $\geq$10 mut/Mb: TMB-high (potential immunotherapy benefit)
\item 6-9 mut/Mb: TMB-intermediate
\item <6 mut/Mb: TMB-low
\end{itemize}
\textbf{Result}: [TMB-high / TMB-intermediate / TMB-low]
\textbf{Clinical Implication}:
\begin{itemize}
\item TMB-high: Consider immunotherapy; pembrolizumab FDA-approved for TMB-H ($\geq$10) solid tumors
\item TMB-intermediate/low: Standard chemotherapy or biomarker-directed therapy
\end{itemize}
\subsection{Microsatellite Instability (MSI)}
\textbf{MSI Status}: [MSI-H / MSI-L / MSS]
\textbf{Method}: [NGS-based MSI calling / PCR-based assay]
\textbf{Clinical Implication}:
\begin{itemize}
\item MSI-H: Immunotherapy highly effective (ORR 30-60\%); pembrolizumab, nivolumab approved
\item MSS: Standard therapy; MSI-H-specific therapies not indicated
\item If MSI-H + [relevant cancer] + young age: Consider germline Lynch syndrome testing
\end{itemize}
\section{Integrated Treatment Recommendations}
\begin{tcolorbox}[enhanced,colback=stronggreen!10,colframe=tier1green,
title=\textbf{PERSONALIZED TREATMENT PLAN},fonttitle=\bfseries,coltitle=black]
{\small
Based on the genomic profile, the following treatment approach is recommended:
\textbf{Primary Recommendation (GRADE 1A)}:
\begin{itemize}
\item \textbf{[Drug targeting identified alteration]}
\item Dosing: [Specific dose and schedule]
\item Evidence: [Supporting data]
\item Expected outcomes: ORR XX\%, median PFS XX months
\end{itemize}
\textbf{If Primary Recommendation Contraindicated}:
\begin{itemize}
\item Alternative 1: [Second-line biomarker-directed option]
\item Alternative 2: [Standard therapy if targeted therapy ineligible]
\end{itemize}
\textbf{At Progression}:
\begin{itemize}
\item Repeat molecular profiling (liquid biopsy or tissue) for resistance mechanisms
\item Expected resistance alterations: [e.g., EGFR T790M, MET amplification]
\item Sequential targeted therapy if secondary actionable alteration identified
\end{itemize}
\textbf{Clinical Trial Matching}:
\begin{itemize}
\item [List relevant trials based on identified alterations]
\item ClinicalTrials.gov search terms: [Suggested keywords]
\end{itemize}
}
\end{tcolorbox}
\section{Clinical Trial Matching}
\begin{table}[H]
\centering
\small
\begin{tabular}{llll}
\toprule
\textbf{Trial} & \textbf{Intervention} & \textbf{Biomarker} & \textbf{Phase} \\
\midrule
[NCT Number] & [Drug/regimen] & [Matching biomarker] & Phase [1/2/3] \\
[NCT Number] & [Drug/regimen] & [Matching biomarker] & Phase [1/2/3] \\
\bottomrule
\end{tabular}
\caption{Potential clinical trials based on molecular profile (as of [date])}
\end{table}
\textit{Note: Trial availability changes frequently. Search ClinicalTrials.gov for current options.}
\section{Methodology}
\subsection{Assay Information}
\textbf{Test Name}: [FoundationOne CDx / Custom NGS Panel / Other]\\
\textbf{Methodology}: Next-generation sequencing (NGS)\\
\textbf{Genes Analyzed}: [Number] genes for SNVs, indels, CNVs, and rearrangements\\
\textbf{Coverage Depth}: [XXX]x median coverage\\
\textbf{Limit of Detection}: [X\%] variant allele frequency
\textbf{Specimen Details}:
\begin{itemize}
\item Specimen type: [FFPE tissue block / Blood (ctDNA)]
\item Tumor content: [XX\%] (minimum 20\% required for optimal sensitivity)
\item DNA quality: [Adequate / Suboptimal]
\item DNA quantity: [XX ng] (minimum [Y ng] required)
\end{itemize}
\subsection{Interpretation}
\textbf{Variant Classification}:
\begin{itemize}
\item Pathogenic: Disease-causing, clinically significant
\item Likely Pathogenic: Probably disease-causing based on available evidence
\item VUS: Uncertain significance, insufficient evidence for classification
\item Likely Benign: Probably not disease-causing
\item Benign: Not disease-causing
\end{itemize}
\textbf{Databases Referenced}:
\begin{itemize}
\item OncoKB (Memorial Sloan Kettering)
\item CIViC (Clinical Interpretations of Variants in Cancer)
\item ClinVar (NCBI)
\item COSMIC (Catalogue of Somatic Mutations in Cancer)
\item [Others - PMKB, CGI, etc.]
\end{itemize}
\section{Limitations}
\begin{itemize}
\item This test analyzes [somatic/germline] alterations in tumor tissue. [If somatic: Results not informative for inherited cancer risk]
\item Negative result does not exclude presence of alterations in genes not covered by this panel
\item Low VAF alterations (<5\%) may not be detected due to assay sensitivity limits
\item Copy number analysis limited for small amplifications or deletions
\item Structural variants detection depends on breakpoint location within sequenced regions
\item TMB and MSI calculations are estimate-based; consider orthogonal testing if borderline
\end{itemize}
\section{Recommendations for Referring Clinician}
\begin{enumerate}
\item \textbf{[Action 1]}: [e.g., Initiate targeted therapy with drug X based on detected alteration]
\item \textbf{[Action 2]}: [e.g., Consider clinical trial enrollment for Tier 2 alteration]
\item \textbf{[Action 3]}: [e.g., Repeat molecular profiling at progression to identify resistance mechanisms]
\item \textbf{[Action 4]}: [e.g., If MSI-H detected and patient <50 years, refer for genetic counseling for Lynch syndrome]
\item \textbf{[Action 5]}: [e.g., Share report with molecular tumor board for complex decision-making]
\end{enumerate}
\section{References}
\begin{enumerate}
\item [FDA Label for companion diagnostic]
\item [Key clinical trial supporting biomarker-therapy association]
\item [NCCN Guideline reference]
\item [OncoKB database version]
\item [Assay validation publication]
\end{enumerate}
\vspace{10pt}
\hrule
\vspace{4pt}
{\footnotesize
\textbf{Laboratory Director}: [Name, MD, PhD] | [Board certifications]\\
\textbf{Report Authorized By}: [Name, credentials] | Date: [Date]\\
\textbf{Laboratory}: [Name, address]\\
\textbf{CLIA \#}: [Number] | \textbf{CAP \#}: [Number]\\
\textbf{Questions}: Contact [Name] at [Phone] or [Email]
\vspace{2pt}
\textit{This report is intended for use by qualified healthcare professionals. The information provided is based on current scientific literature and databases. Interpretation and treatment decisions should be made by qualified physicians in consultation with the patient. This test was performed in a CLIA-certified, CAP-accredited laboratory.}
}
\end{document}
\documentclass[10pt,letterpaper,landscape]{article}
% Landscape for wider flowcharts
\usepackage[margin=0.4in]{geometry}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{helvet}
\renewcommand{\familydefault}{\sfdefault}
\usepackage{xcolor}
\usepackage{tcolorbox}
\usepackage{tikz}
\usetikzlibrary{shapes,arrows,positioning,fit,calc}
\usepackage{fancyhdr}
% Color definitions
\definecolor{headerblue}{RGB}{0,102,204}
\definecolor{actiongreen}{RGB}{0,153,76}
\definecolor{decisionyellow}{RGB}{255,193,7}
\definecolor{urgentred}{RGB}{220,20,60}
\definecolor{infobox}{RGB}{33,150,243}
\definecolor{routineblue}{RGB}{100,181,246}
% Header/footer
\pagestyle{fancy}
\fancyhf{}
\fancyhead[L]{\footnotesize \textbf{Clinical Pathway: [CONDITION/DISEASE]}}
\fancyhead[R]{\footnotesize Version X.X | [Date]}
\renewcommand{\headrulewidth}{0.5pt}
\fancyfoot[C]{\footnotesize Evidence-Based Clinical Decision Pathway | For Professional Use Only | Page \thepage}
% TikZ styles
\tikzstyle{startstop} = [rectangle, rounded corners=8pt, minimum width=3cm, minimum height=1cm, text centered, draw=black, fill=headerblue!20, font=\small\bfseries]
\tikzstyle{decision} = [diamond, minimum width=3cm, minimum height=1.2cm, text centered, draw=black, fill=decisionyellow!40, font=\small, aspect=2, inner sep=0pt]
\tikzstyle{process} = [rectangle, rounded corners=4pt, minimum width=3.5cm, minimum height=0.9cm, text centered, draw=black, fill=actiongreen!20, font=\small]
\tikzstyle{urgent} = [rectangle, rounded corners=4pt, minimum width=3.5cm, minimum height=0.9cm, text centered, draw=urgentred, line width=1.5pt, fill=urgentred!15, font=\small\bfseries]
\tikzstyle{routine} = [rectangle, rounded corners=4pt, minimum width=3.5cm, minimum height=0.9cm, text centered, draw=black, fill=routineblue!20, font=\small]
\tikzstyle{info} = [rectangle, rounded corners=2pt, minimum width=2.5cm, minimum height=0.7cm, text centered, draw=infobox, fill=infobox!10, font=\footnotesize]
\tikzstyle{arrow} = [thick,->,>=stealth]
\tikzstyle{urgentarrow} = [ultra thick,->,>=stealth,color=urgentred]
\setlength{\parindent}{0pt}
\begin{document}
\begin{center}
{\fontsize{16}{18}\selectfont\bfseries\color{headerblue} CLINICAL DECISION PATHWAY}\\[2pt]
{\fontsize{13}{15}\selectfont\bfseries [Disease/Condition - e.g., Acute Chest Pain Management]}\\[2pt]
{\fontsize{10}{12}\selectfont [Institution Name] | Version X.X | Effective Date: [Date]}
\end{center}
\vspace{6pt}
% Legend box
\begin{tcolorbox}[colback=white,colframe=black,width=\textwidth]
\begin{minipage}{0.48\textwidth}
\textbf{Pathway Symbols:}\\[2pt]
\begin{tikzpicture}[node distance=0.5cm]
\node[startstop, scale=0.7] (start) {Start/End};
\node[decision, right=1cm of start, scale=0.7] (dec) {Decision\\Point};
\node[process, right=1cm of dec, scale=0.7] (proc) {Action/Process};
\end{tikzpicture}
\end{minipage}
\begin{minipage}{0.48\textwidth}
\textbf{Urgency Color Coding:}\\[2pt]
\begin{tikzpicture}[node distance=0.5cm]
\node[urgent, scale=0.7] (urg) {URGENT\\<1 hour};
\node[process, right=1cm of urg, scale=0.7] (sem) {Semi-Urgent\\<24 hours};
\node[routine, right=1cm of sem, scale=0.7] (rout) {Routine\\>24 hours};
\end{tikzpicture}
\end{minipage}
\end{tcolorbox}
\vspace{4pt}
% Main flowchart
\begin{center}
\begin{tikzpicture}[node distance=2.2cm and 3cm, auto]
% Start
\node [startstop] (start) {Patient Presentation:\\[2pt] [Chief Complaint]};
% First decision
\node [decision, below=of start] (decision1) {[Critical\\Criteria\\Present?]};
% Urgent pathway (left branch)
\node [urgent, left=of decision1, below=1.8cm] (urgent1) {IMMEDIATE ACTION:\\[2pt] [Specific intervention]\\[2pt] Call Code/Transfer};
% Continue evaluation (right branch)
\node [process, right=of decision1, below=1.8cm] (eval1) {Continue\\Evaluation:\\[2pt][Tests/Assessment]};
% Second decision
\node [decision, below=of eval1] (decision2) {[Risk\\Score\\$\geq$X?]};
% High risk pathway
\node [urgent, left=of decision2, below=1.8cm] (high) {HIGH RISK:\\[2pt] Admit ICU/Telemetry\\[2pt] [Specific management]};
% Moderate risk
\node [process, below=of decision2] (moderate) {MODERATE RISK:\\[2pt] Admit for observation\\[2pt] Serial testing};
% Low risk pathway
\node [routine, right=of decision2, below=1.8cm] (low) {LOW RISK:\\[2pt] Outpatient management\\[2pt] Follow-up in X days};
% Final outcome node
\node [startstop, below=of moderate, node distance=2.5cm] (outcome) {Definitive Management\\Based on Results};
% Arrows
\draw [urgentarrow] (start) -- (decision1);
\draw [urgentarrow] (decision1) -| node[near start,left] {YES} (urgent1);
\draw [arrow] (decision1) -| node[near start,right] {NO} (eval1);
\draw [arrow] (eval1) -- (decision2);
\draw [arrow] (decision2) -| node[near start,left] {HIGH} (high);
\draw [arrow] (decision2) -- node[right] {MODERATE} (moderate);
\draw [arrow] (decision2) -| node[near start,right] {LOW} (low);
\draw [arrow] (urgent1) |- (outcome);
\draw [arrow] (high) |- (outcome);
\draw [arrow] (moderate) -- (outcome);
\draw [arrow] (low) |- (outcome);
% Information boxes
\node [info, right=1.5cm of eval1] (info1) {[Criteria]:\\[1pt] \footnotesize • Item 1\\• Item 2\\• Item 3};
\node [info, right=1.5cm of decision2] (info2) {[Score]:\\[1pt] \footnotesize Calculate:\\risk score};
\end{tikzpicture}
\end{center}
\vspace{8pt}
% Detailed pathway steps
\begin{tcolorbox}[colback=highlightgray!30,colframe=headerblue,title=\textbf{Detailed Pathway Steps},fonttitle=\bfseries]
\textbf{STEP 1: Initial Assessment}
\begin{itemize}
\item Vital signs: BP, HR, RR, temp, O₂ saturation
\item Focused history: [Key elements]
\item Physical examination: [Key findings]
\item Initial labs: [Specify tests]
\item ECG (if applicable)
\end{itemize}
\textbf{STEP 2: Risk Stratification}
\begin{itemize}
\item Calculate [Risk Score Name] (see scoring table below)
\item Identify high-risk features requiring immediate intervention
\item Document risk category in medical record
\end{itemize}
\textbf{STEP 3: Treatment Initiation}
\begin{itemize}
\item Urgent: [Specific interventions within 1 hour]
\item Semi-urgent: [Interventions within 24 hours]
\item Routine: [Standard management approach]
\end{itemize}
\textbf{STEP 4: Monitoring and Reassessment}
\begin{itemize}
\item Frequency: [Based on risk category]
\item Parameters: [What to monitor]
\item Escalation criteria: [When to intensify treatment]
\item De-escalation criteria: [When to transition to lower intensity]
\end{itemize}
\end{tcolorbox}
\vspace{4pt}
% Risk scoring table
\begin{tcolorbox}[colback=white,colframe=headerblue,title=\textbf{[Risk Score Name] Calculation},fonttitle=\bfseries]
{\small
\begin{tabular}{lc}
\toprule
\textbf{Clinical Feature} & \textbf{Points} \\
\midrule
[Feature 1 - e.g., Age $\geq$65 years] & +1 \\
[Feature 2 - e.g., Prior history] & +1 \\
[Feature 3 - e.g., Abnormal lab value] & +2 \\
[Feature 4 - e.g., Specific symptom] & +1 \\
[Feature 5 - e.g., Imaging finding] & +2 \\
\midrule
\textbf{Total Score} & \textbf{0-X points} \\
\bottomrule
\end{tabular}
\vspace{4pt}
\textbf{Risk Categories}:
\begin{itemize}
\item \textbf{Low Risk}: 0-1 points → [Management approach, predicted outcome]
\item \textbf{Moderate Risk}: 2-3 points → [Management approach, predicted outcome]
\item \textbf{High Risk}: $\geq$4 points → [Management approach, predicted outcome]
\end{itemize}
}
\end{tcolorbox}
\vspace{4pt}
% Evidence basis
\begin{tcolorbox}[colback=actiongreen!5,colframe=actiongreen,title=\textbf{Evidence Basis for Pathway},fonttitle=\bfseries]
{\small
\textbf{Key Supporting Evidence}:
\begin{enumerate}
\item \textbf{[Clinical Trial/Study]}: [Key finding supporting pathway decision]
\item \textbf{Guidelines}: NCCN/ASCO/AHA/ACC/[Relevant society] [Year] - [Recommendation level]
\item \textbf{Meta-Analysis}: [If applicable - pooled results supporting approach]
\end{enumerate}
\textbf{Validation}: Pathway validated at [institution] with [X\%] adherence rate and [outcome metrics].
\textbf{Last Updated}: [Date] based on [new trial, guideline update, or scheduled review]
}
\end{tcolorbox}
\vspace{8pt}
\hrule
\vspace{4pt}
{\footnotesize
\textbf{Pathway Committee}: [Names, titles] | \textbf{Approved}: [Date] | \textbf{Next Review}: [Date]\\
\textbf{Contact for Questions}: [Name, email, phone]
}
\end{document}
\documentclass[10pt,letterpaper]{article}
% Packages
\usepackage[margin=0.5in]{geometry}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{helvet}
\renewcommand{\familydefault}{\sfdefault}
\usepackage{xcolor}
\usepackage{tcolorbox}
\usepackage{array}
\usepackage{tabularx}
\usepackage{booktabs}
\usepackage{enumitem}
\usepackage{titlesec}
\usepackage{fancyhdr}
\usepackage{multicol}
\usepackage{graphicx}
\usepackage{float}
% Color definitions
\definecolor{headerblue}{RGB}{0,102,204}
\definecolor{highlightgreen}{RGB}{0,153,76}
\definecolor{warningred}{RGB}{204,0,0}
\definecolor{highlightgray}{RGB}{240,240,240}
\definecolor{biomarkerblue}{RGB}{51,102,204}
% Section formatting - compact
\titleformat{\section}{\normalfont\fontsize{11}{12}\bfseries\color{headerblue}}{\thesection}{0.5em}{}
\titlespacing*{\section}{0pt}{4pt}{2pt}
\titleformat{\subsection}{\normalfont\fontsize{10}{11}\bfseries}{\thesubsection}{0.5em}{}
\titlespacing*{\subsection}{0pt}{3pt}{1pt}
% List formatting - ultra compact
\setlist[itemize]{leftmargin=*,itemsep=0pt,parsep=0pt,topsep=1pt}
\setlist[enumerate]{leftmargin=*,itemsep=0pt,parsep=0pt,topsep=1pt}
% Remove paragraph indentation
\setlength{\parindent}{0pt}
\setlength{\parskip}{2pt}
% Header/footer
\pagestyle{fancy}
\fancyhf{}
\fancyhead[L]{\footnotesize \textbf{Clinical Decision Support: [COHORT NAME]}}
\fancyhead[R]{\footnotesize Page \thepage}
\renewcommand{\headrulewidth}{0.5pt}
\fancyfoot[C]{\footnotesize Confidential Medical Document - For Professional Use Only}
\begin{document}
% Title block - compact
\begin{center}
{\fontsize{14}{16}\selectfont\bfseries\color{headerblue} PATIENT COHORT ANALYSIS REPORT}\\[2pt]
{\fontsize{12}{14}\selectfont\bfseries [Cohort Description - e.g., NSCLC Patients Stratified by PD-L1 Expression]}\\[2pt]
{\fontsize{10}{12}\selectfont [Institution/Study Name]}\\[1pt]
{\fontsize{9}{11}\selectfont Report Date: [Date]}
\end{center}
\vspace{4pt}
% Executive Summary Box
\begin{tcolorbox}[colback=highlightgray,colframe=headerblue,title=\textbf{Executive Summary},fonttitle=\bfseries\small,coltitle=black]
{\small
\textbf{Cohort}: [n=XX] patients with [disease] stratified by [biomarker/characteristic]
\textbf{Key Findings}:
\begin{itemize}
\item [Primary finding - e.g., Biomarker+ patients had significantly longer PFS]
\item [Secondary finding - e.g., ORR 45\% vs 30\%, p=0.023]
\item [Safety finding - e.g., Similar toxicity profiles between groups]
\end{itemize}
\textbf{Clinical Implications}: [Treatment recommendations based on findings]
}
\end{tcolorbox}
\vspace{2pt}
\section{Cohort Characteristics}
\subsection{Patient Demographics}
[Narrative description of cohort composition, inclusion/exclusion criteria, time period]
\begin{table}[H]
\centering
\small
\begin{tabular}{lccc}
\toprule
\textbf{Characteristic} & \textbf{Group A (n=XX)} & \textbf{Group B (n=XX)} & \textbf{p-value} \\
\midrule
Age, years (median [IQR]) & XX [XX-XX] & XX [XX-XX] & X.XX \\
Sex, n (\%) & & & \\
\quad Male & XX (XX\%) & XX (XX\%) & X.XX \\
\quad Female & XX (XX\%) & XX (XX\%) & \\
ECOG PS, n (\%) & & & \\
\quad 0-1 & XX (XX\%) & XX (XX\%) & X.XX \\
\quad 2 & XX (XX\%) & XX (XX\%) & \\
Disease Stage, n (\%) & & & \\
\quad III & XX (XX\%) & XX (XX\%) & X.XX \\
\quad IV & XX (XX\%) & XX (XX\%) & \\
Prior Lines of Therapy & & & \\
\quad 0 (treatment-naïve) & XX (XX\%) & XX (XX\%) & X.XX \\
\quad 1-2 & XX (XX\%) & XX (XX\%) & \\
\quad $\geq$3 & XX (XX\%) & XX (XX\%) & \\
\bottomrule
\end{tabular}
\caption{Baseline patient demographics and clinical characteristics}
\end{table}
\subsection{Biomarker Profile}
\begin{tcolorbox}[colback=biomarkerblue!10,colframe=biomarkerblue,title=\textbf{Biomarker Stratification},fonttitle=\bfseries\small]
{\small
\textbf{Classification Method}: [e.g., IHC for PD-L1 expression, NGS for mutations, gene expression clustering]
\textbf{Group Definitions}:
\begin{itemize}
\item \textbf{Group A (Biomarker+)}: [n=XX] - [Definition, e.g., PD-L1 TPS $\geq$50\%, or Mesenchymal-Immune-Active subtype]
\item \textbf{Group B (Biomarker-)}: [n=XX] - [Definition, e.g., PD-L1 TPS <50\%]
\end{itemize}
\textbf{Molecular Features of Group A}:
\begin{itemize}
\item [Feature 1]: XX\% (n=XX) - [Clinical significance]
\item [Feature 2]: XX\% (n=XX) - [Clinical significance]
\item [Feature 3]: Elevated/decreased [marker] (median [value])
\end{itemize}
}
\end{tcolorbox}
\section{Treatment Exposures}
\begin{table}[H]
\centering
\small
\begin{tabular}{lcc}
\toprule
\textbf{Treatment Received} & \textbf{Group A, n (\%)} & \textbf{Group B, n (\%)} \\
\midrule
[Treatment regimen 1] & XX (XX\%) & XX (XX\%) \\
[Treatment regimen 2] & XX (XX\%) & XX (XX\%) \\
[Treatment regimen 3] & XX (XX\%) & XX (XX\%) \\
Median cycles received (range) & X (X-X) & X (X-X) \\
\bottomrule
\end{tabular}
\caption{Treatment exposures by biomarker group}
\end{table}
\section{Treatment Outcomes}
\subsection{Response Rates}
\begin{table}[H]
\centering
\small
\begin{tabular}{lccc}
\toprule
\textbf{Response Category} & \textbf{Group A (n=XX)} & \textbf{Group B (n=XX)} & \textbf{p-value} \\
\midrule
Objective Response Rate (ORR) & XX\% [95\% CI] & XX\% [95\% CI] & X.XXX \\
\quad Complete Response (CR) & XX (XX\%) & XX (XX\%) & \\
\quad Partial Response (PR) & XX (XX\%) & XX (XX\%) & \\
Disease Control Rate (DCR) & XX\% [95\% CI] & XX\% [95\% CI] & X.XXX \\
\quad Stable Disease (SD) & XX (XX\%) & XX (XX\%) & \\
Progressive Disease (PD) & XX (XX\%) & XX (XX\%) & \\
\midrule
Median Duration of Response (months) & X.X (95\% CI X.X-X.X) & X.X (95\% CI X.X-X.X) & X.XXX \\
\bottomrule
\end{tabular}
\caption{Best overall response by biomarker group (RECIST v1.1 criteria)}
\end{table}
\subsection{Survival Outcomes}
\textbf{Progression-Free Survival (PFS)}:
\begin{itemize}
\item Group A: Median X.X months (95\% CI X.X-X.X), 12-month PFS rate: XX\%
\item Group B: Median X.X months (95\% CI X.X-X.X), 12-month PFS rate: XX\%
\item Hazard Ratio: X.XX (95\% CI X.XX-X.XX), log-rank p = X.XXX
\item \textit{[Interpretation: Group A had XX\% reduction in risk of progression compared to Group B]}
\end{itemize}
\textbf{Overall Survival (OS)}:
\begin{itemize}
\item Group A: Median XX.X months (95\% CI XX.X-XX.X), 12-month OS rate: XX\%
\item Group B: Median XX.X months (95\% CI XX.X-XX.X), 12-month OS rate: XX\%
\item Hazard Ratio: X.XX (95\% CI X.XX-X.XX), log-rank p = X.XXX
\item \textit{[Interpretation: XX\% reduction in risk of death for Group A]}
\end{itemize}
% Note: Include Kaplan-Meier curves as figures if available
% \begin{figure}[H]
% \centering
% \includegraphics[width=0.9\textwidth]{figures/pfs_by_biomarker.pdf}
% \caption{Progression-free survival by biomarker status}
% \end{figure}
\section{Safety and Tolerability}
\begin{table}[H]
\centering
\small
\begin{tabular}{lcccc}
\toprule
\multirow{2}{*}{\textbf{Adverse Event}} & \multicolumn{2}{c}{\textbf{Any Grade, n (\%)}} & \multicolumn{2}{c}{\textbf{Grade 3-4, n (\%)}} \\
\cmidrule(lr){2-3} \cmidrule(lr){4-5}
& Group A & Group B & Group A & Group B \\
\midrule
[AE 1 - e.g., Fatigue] & XX (XX\%) & XX (XX\%) & X (X\%) & X (X\%) \\
[AE 2 - e.g., Nausea] & XX (XX\%) & XX (XX\%) & X (X\%) & X (X\%) \\
[AE 3 - e.g., Neutropenia] & XX (XX\%) & XX (XX\%) & X (X\%) & X (X\%) \\
[AE 4 - e.g., Diarrhea] & XX (XX\%) & XX (XX\%) & X (X\%) & X (X\%) \\
[AE 5 - immune-related] & XX (XX\%) & XX (XX\%) & X (X\%) & X (X\%) \\
\midrule
Treatment discontinuation & XX (XX\%) & XX (XX\%) & \multicolumn{2}{c}{-} \\
Dose reductions & XX (XX\%) & XX (XX\%) & \multicolumn{2}{c}{-} \\
\bottomrule
\end{tabular}
\caption{Treatment-emergent adverse events by biomarker group (CTCAE v5.0)}
\end{table}
\section{Statistical Analysis}
\subsection{Methods}
\textbf{Study Design}: [Retrospective cohort analysis / Prospective cohort / Post-hoc analysis of clinical trial]
\textbf{Statistical Tests}:
\begin{itemize}
\item Continuous variables: [t-test / Mann-Whitney U test], reported as [mean $\pm$ SD / median [IQR]]
\item Categorical variables: Chi-square test or Fisher's exact test (if expected count <5)
\item Survival analysis: Kaplan-Meier method, log-rank test, Cox proportional hazards regression
\item Significance level: Two-sided p<0.05 considered statistically significant
\item Software: [R version X.X.X, survival package / SAS / Stata / Python lifelines]
\end{itemize}
\subsection{Multivariable Analysis}
Cox regression model adjusting for baseline prognostic factors:
\begin{table}[H]
\centering
\small
\begin{tabular}{lccc}
\toprule
\textbf{Variable} & \textbf{Hazard Ratio} & \textbf{95\% CI} & \textbf{p-value} \\
\midrule
Biomarker+ (vs Biomarker-) & X.XX & X.XX-X.XX & X.XXX \\
Age (per 10 years) & X.XX & X.XX-X.XX & X.XXX \\
ECOG PS 2 (vs 0-1) & X.XX & X.XX-X.XX & X.XXX \\
Stage IV (vs III) & X.XX & X.XX-X.XX & X.XXX \\
[Additional variable] & X.XX & X.XX-X.XX & X.XXX \\
\bottomrule
\end{tabular}
\caption{Multivariable Cox regression for progression-free survival}
\end{table}
\textbf{Interpretation}: After adjusting for age, performance status, and disease stage, [biomarker status] remained an independent predictor of [PFS/OS] (HR X.XX, 95\% CI X.XX-X.XX, p=X.XXX).
\section{Clinical Implications}
\begin{tcolorbox}[colback=highlightgreen!10,colframe=highlightgreen,title=\textbf{Treatment Recommendations},fonttitle=\bfseries\small]
{\small
\textbf{For Biomarker-Positive Patients (Group A)}:
\textbf{Preferred Regimen} (GRADE 1A):
\begin{itemize}
\item [Specific treatment based on biomarker]
\item Evidence: [Trial name/data showing benefit in biomarker+ population]
\item Expected outcomes: ORR XX\%, median PFS XX months
\end{itemize}
\textbf{Monitoring}:
\begin{itemize}
\item Imaging every [X weeks] for response assessment
\item [Specific lab monitoring for biomarker+ patients]
\item Watch for [specific toxicities more common in this group]
\end{itemize}
\textbf{For Biomarker-Negative Patients (Group B)}:
\textbf{Standard Regimen} (GRADE 1B):
\begin{itemize}
\item [Standard therapy for biomarker- population]
\item Expected outcomes: ORR XX\%, median PFS XX months
\item Consider [alternative approaches or clinical trial enrollment]
\end{itemize}
}
\end{tcolorbox}
\section{Subgroup Analyses}
\textbf{Interaction Testing}: Treatment effect by biomarker subgroup (p-interaction = X.XXX)
[Describe whether treatment benefit differs by biomarker status - i.e., predictive biomarker]
Additional exploratory subgroups:
\begin{itemize}
\item Age <65 vs $\geq$65 years
\item Sex (male vs female)
\item Prior lines of therapy (0 vs 1+ prior treatments)
\item Disease burden (high vs low tumor burden)
\end{itemize}
\section{Strengths and Limitations}
\subsection{Strengths}
\begin{itemize}
\item [e.g., Biomarker-stratified analysis with prospectively defined groups]
\item [e.g., Adequate sample size for statistical power]
\item [e.g., Standardized response assessment using RECIST v1.1]
\item [e.g., Multivariable analysis adjusting for confounders]
\end{itemize}
\subsection{Limitations}
\begin{itemize}
\item [e.g., Retrospective design with potential selection bias]
\item [e.g., Single-institution cohort may limit generalizability]
\item [e.g., Biomarker testing not available for all patients (XX\% tested)]
\item [e.g., Limited follow-up for OS (median X months)]
\item [e.g., Heterogeneous treatment regimens across cohort]
\end{itemize}
\section{Conclusions}
[Paragraph summarizing key findings]
[Biomarker-positive patients demonstrated [significantly better/worse] outcomes compared to biomarker-negative patients, with [outcome metric] of [values] (HR X.XX, p=X.XXX). These findings support [biomarker-guided therapy selection / routine biomarker testing / specific treatment approach].]
[Future directions: Prospective validation in independent cohort, investigation of mechanisms, clinical trial design implications]
\section{References}
\begin{enumerate}
\item [Reference 1 - Key clinical trial]
\item [Reference 2 - Biomarker validation study]
\item [Reference 3 - Guideline reference (NCCN, ASCO, ESMO)]
\item [Reference 4 - Statistical methods reference]
\item [Reference 5 - Additional supporting evidence]
\end{enumerate}
\vspace{10pt}
\hrule
\vspace{4pt}
{\footnotesize
\textbf{Report Prepared By}: [Name, Title]\\
\textbf{Date}: [Date]\\
\textbf{Contact}: [Email/Phone]\\
\textbf{Institutional Review}: [IRB approval number if applicable]\\
\textbf{Data Cut-Off Date}: [Date]\\
\textbf{Confidentiality}: This document contains proprietary clinical data. Distribution restricted to authorized personnel only.
}
\end{document}
% Clinical Decision Support Color Schemes
% For use in LaTeX documents
% ============================================================================
% PRIMARY THEME COLORS
% ============================================================================
% Header and structural elements
\definecolor{headerblue}{RGB}{0,102,204} % Section headers, titles
\definecolor{highlightgray}{RGB}{240,240,240} % Background boxes
% ============================================================================
% RECOMMENDATION STRENGTH COLORS
% ============================================================================
% Strong recommendations (benefits clearly outweigh risks)
\definecolor{stronggreen}{RGB}{0,153,76} % Grade 1A, 1B
\definecolor{strongdark}{RGB}{0,120,60} % Darker variant for emphasis
% Conditional recommendations (trade-offs exist)
\definecolor{conditionalyellow}{RGB}{255,193,7} % Grade 2A, 2B, 2C
\definecolor{conditionalamber}{RGB}{255,160,0} % Darker variant
% Research/Investigational (insufficient evidence)
\definecolor{researchblue}{RGB}{33,150,243} % Clinical trials
\definecolor{researchdark}{RGB}{25,118,210} % Darker variant
% Not recommended / Contraindicated
\definecolor{warningred}{RGB}{204,0,0} % Strong recommendation against
\definecolor{dangerred}{RGB}{220,20,60} % Critical warnings, urgent actions
% ============================================================================
% URGENCY LEVELS (Clinical Pathways)
% ============================================================================
\definecolor{urgentred}{RGB}{220,20,60} % Immediate action (<1 hour)
\definecolor{semiurgent}{RGB}{255,152,0} % Action within 24 hours
\definecolor{routineblue}{RGB}{100,181,246} % Routine care (>24 hours)
\definecolor{actiongreen}{RGB}{0,153,76} % Standard interventions
% ============================================================================
% BIOMARKER CATEGORIES
% ============================================================================
% Alteration types
\definecolor{mutationred}{RGB}{244,67,54} % Point mutations, SNVs
\definecolor{amplificationblue}{RGB}{33,150,243} % Copy number gains
\definecolor{deletionpurple}{RGB}{156,39,176} % Copy number losses
\definecolor{fusionpurple}{RGB}{156,39,176} % Gene fusions/rearrangements
\definecolor{expressionorange}{RGB}{255,152,0} % Expression alterations
% Actionability tiers
\definecolor{tier1green}{RGB}{0,153,76} % FDA-approved therapy
\definecolor{tier2orange}{RGB}{255,152,0} % Clinical trial/off-label
\definecolor{tier3gray}{RGB}{158,158,158} % VUS, no action
% ============================================================================
% STATISTICAL SIGNIFICANCE
% ============================================================================
\definecolor{significant}{RGB}{0,153,76} % p < 0.05, statistically significant
\definecolor{trending}{RGB}{255,193,7} % p = 0.05-0.10, trending
\definecolor{nonsignificant}{RGB}{158,158,158} % p > 0.10, not significant
% ============================================================================
% OUTCOME CATEGORIES
% ============================================================================
% Response assessment (RECIST)
\definecolor{completeresponse}{RGB}{0,153,76} % CR (complete response)
\definecolor{partialresponse}{RGB}{76,175,80} % PR (partial response)
\definecolor{stabledisease}{RGB}{255,193,7} % SD (stable disease)
\definecolor{progressivedisease}{RGB}{244,67,54} % PD (progressive disease)
% Survival outcomes
\definecolor{survivedgreen}{RGB}{0,153,76} % Patient alive
\definecolor{eventred}{RGB}{244,67,54} % Event occurred (death, progression)
\definecolor{censoredgray}{RGB}{158,158,158} % Censored observation
% ============================================================================
% ADVERSE EVENT SEVERITY (CTCAE)
% ============================================================================
\definecolor{grade1}{RGB}{255,235,59} % Mild
\definecolor{grade2}{RGB}{255,193,7} % Moderate
\definecolor{grade3}{RGB}{255,152,0} % Severe
\definecolor{grade4}{RGB}{244,67,54} % Life-threatening
\definecolor{grade5}{RGB}{198,40,40} % Fatal
% ============================================================================
% COLORBLIND-SAFE PALETTE (Okabe-Ito)
% ============================================================================
% Use these for graphs/figures to ensure accessibility
\definecolor{okabe1}{RGB}{230,159,0} % Orange
\definecolor{okabe2}{RGB}{86,180,233} % Sky blue
\definecolor{okabe3}{RGB}{0,158,115} % Bluish green
\definecolor{okabe4}{RGB}{240,228,66} % Yellow
\definecolor{okabe5}{RGB}{0,114,178} % Blue
\definecolor{okabe6}{RGB}{213,94,0} % Vermillion
\definecolor{okabe7}{RGB}{204,121,167} % Reddish purple
% ============================================================================
% USAGE EXAMPLES
% ============================================================================
% Example 1: Strong recommendation box
% \begin{tcolorbox}[enhanced,colback=stronggreen!10,colframe=stronggreen,
% title={\textbf{STRONG RECOMMENDATION} \hfill \textbf{GRADE: 1A}}]
% We recommend osimertinib for EGFR-mutated NSCLC...
% \end{tcolorbox}
% Example 2: Conditional recommendation box
% \begin{tcolorbox}[enhanced,colback=conditionalyellow!10,colframe=conditionalyellow,
% title={\textbf{CONDITIONAL RECOMMENDATION} \hfill \textbf{GRADE: 2B}}]
% We suggest considering maintenance therapy...
% \end{tcolorbox}
% Example 3: Biomarker alteration
% \colorbox{mutationred!60}{\textcolor{white}{\textbf{MUTATION}}}
% Example 4: Statistical significance in table
% \cellcolor{significant!20} p < 0.001
% Example 5: Adverse event severity
% \textcolor{grade3}{Grade 3} or \colorbox{grade3!30}{Grade 3}
% ============================================================================
% ACCESSIBILITY NOTES
% ============================================================================
% 1. Always use sufficient color contrast (4.5:1 ratio for normal text)
% 2. Do not rely on color alone - use symbols/text as well
% 3. Test in grayscale to ensure readability
% 4. Use Okabe-Ito palette for colorblind accessibility in figures
% 5. Add text labels to colored boxes ("STRONG", "CONDITIONAL", etc.)
% ============================================================================
% STYLE CONSISTENCY
% ============================================================================
% Font: Helvetica (sans-serif) for clinical documents
% Margins: 0.5 inches for compact professional appearance
% Font sizes: 10pt body, 11pt subsections, 12-14pt headers
% Line spacing: Compact (minimal whitespace for dense information)
% Boxes: tcolorbox with rounded corners, colored backgrounds at 10-20% opacity
% End of color scheme definitions
Example: GBM Molecular Subtype Cohort Analysis
Clinical Context
This example demonstrates a patient cohort analysis stratified by molecular biomarkers, similar to the GBM Mesenchymal-Immune-Active cluster analysis provided as reference.
Cohort Overview
Disease: Glioblastoma (GBM), IDH-wild-type
Study Population: n=60 patients with newly diagnosed GBM treated with standard Stupp protocol (temozolomide + radiation → adjuvant temozolomide)
Molecular Classification: Verhaak 2010 subtypes with immune signature refinement
- Group A: Mesenchymal-Immune-Active subtype (n=18, 30%)
- Group B: Other molecular subtypes (Proneural, Classical, Neural) (n=42, 70%)
Study Period: January 2019 - December 2022
Data Source: Single academic medical center, retrospective cohort analysis
Biomarker Classification
Mesenchymal-Immune-Active Subtype Characteristics
Molecular Features:
- NF1 alterations (mutations or deletions): 72% (13/18)
- High YKL-40 (CHI3L1) expression: 100% (18/18, median z-score +2.8)
- Immune gene signature: Elevated (median ESTIMATE immune score +1250)
- CD163+ macrophage infiltration: High density (median 195 cells/mm², range 120-340)
- MES (mesenchymal) signature score: >0.5 (all patients)
Clinical Characteristics:
- Median age: 64 years (range 42-76)
- Male: 61% (11/18)
- Tumor location: Temporal lobe predominant (55%)
- Multifocal disease: 33% (6/18) - higher than overall cohort
Comparison Groups (Other Subtypes)
Molecular Features:
- Proneural: n=15 (25%) - PDGFRA amplification, younger age
- Classical: n=18 (30%) - EGFR amplification, chromosome 7+/10-
- Neural: n=9 (15%) - neuronal markers, may include normal tissue
Treatment Outcomes
Response Assessment (RANO Criteria)
Objective Response Rate (after chemoradiation, ~3 months):
- Mesenchymal-Immune-Active: 6/18 (33%) - CR 0, PR 6
- Other subtypes: 18/42 (43%) - CR 1, PR 17
- p = 0.48 (Fisher's exact)
Interpretation: No significant difference in initial response rates
Survival Outcomes
Progression-Free Survival (PFS):
- Mesenchymal-Immune-Active: Median 7.2 months (95% CI 5.8-9.1)
- Other subtypes: Median 9.5 months (95% CI 8.1-11.3)
- Hazard Ratio: 1.58 (95% CI 0.89-2.81), p = 0.12
- 6-month PFS rate: 61% vs 74%
Overall Survival (OS):
- Mesenchymal-Immune-Active: Median 12.8 months (95% CI 10.2-15.4)
- Other subtypes: Median 16.3 months (95% CI 14.7-18.9)
- Hazard Ratio: 1.72 (95% CI 0.95-3.11), p = 0.073
- 12-month OS rate: 55% vs 68%
- 24-month OS rate: 17% vs 31%
Interpretation: Trend toward worse survival in mesenchymal-immune-active subtype, not reaching statistical significance in this cohort size
Response to Bevacizumab at Recurrence
Subset Analysis (patients receiving bevacizumab at first recurrence, n=35):
- Mesenchymal-Immune-Active: n=12
- ORR: 58% (7/12)
- Median PFS2 (from bevacizumab start): 6.8 months
- Other subtypes: n=23
- ORR: 35% (8/23)
- Median PFS2: 4.2 months
- p = 0.19 (Fisher's exact for ORR)
- HR for PFS2: 0.62 (95% CI 0.29-1.32), p = 0.21
Interpretation: Exploratory finding suggesting enhanced benefit from bevacizumab in mesenchymal-immune-active subtype (not statistically significant with small sample)
Safety Profile
Treatment-Related Adverse Events (Temozolomide):
No significant differences in toxicity between molecular subtypes:
- Lymphopenia (any grade): 89% vs 86%, p = 0.77
- Thrombocytopenia (grade 3-4): 22% vs 19%, p = 0.79
- Fatigue (any grade): 94% vs 90%, p = 0.60
- Treatment discontinuation: 17% vs 14%, p = 0.77
Clinical Implications
Treatment Recommendations
For Mesenchymal-Immune-Active GBM:
1. First-Line: Standard Stupp protocol (no change based on subtype)
- Evidence: No proven benefit for alternative first-line strategies
- GRADE: 1A (strong recommendation, high-quality evidence)
2. At Recurrence - Consider Bevacizumab Earlier:
- Rationale: Exploratory data suggesting enhanced anti-angiogenic response
- Evidence: Mesenchymal GBM has high VEGF expression, angiogenic phenotype
- GRADE: 2C (conditional recommendation, low-quality evidence from subset)
3. Clinical Trial Enrollment - Immunotherapy Combinations:
- Rationale: High immune cell infiltration may predict immunotherapy benefit
- Targets: PD-1/PD-L1 blockade ± anti-CTLA-4 or anti-angiogenic agents
- Evidence: Ongoing trials (CheckMate-498, CheckMate-548 showed negative results, but did not select for immune-active)
- GRADE: R (research recommendation)
For Other GBM Subtypes:
- Standard treatment per NCCN guidelines
- Consider tumor treating fields (Optune) after radiation completion
- Clinical trials based on specific molecular features (EGFR amplification → EGFR inhibitor trials)
Prognostic Information
Counseling Patients:
- Mesenchymal-immune-active subtype associated with trend toward shorter survival (12.8 vs 16.3 months)
- Not definitive due to small sample size and confidence intervals overlapping
- Prospective validation needed
- Should not alter standard first-line treatment
Study Limitations
1. Small Sample Size: n=18 in mesenchymal-immune-active group limits statistical power 2. Retrospective Design: Potential selection bias, unmeasured confounders 3. Single Institution: May not generalize to other populations 4. Heterogeneous Recurrence Treatment: Not all patients received bevacizumab; treatment selection bias 5. Molecular Classification: Based on bulk tumor RNA-seq; intratumoral heterogeneity not captured 6. No Central Pathology Review: Molecular classification performed locally
Future Directions
1. Prospective Validation: Confirm survival differences in independent cohort (n>100 per group for adequate power) 2. Biomarker Testing: Develop clinically feasible assay for mesenchymal-immune subtype identification 3. Clinical Trial Design: Immunotherapy combinations targeting mesenchymal-immune-active GBM specifically 4. Mechanistic Studies: Investigate why mesenchymal-immune GBM may respond better to bevacizumab 5. Longitudinal Analysis: Track molecular subtype evolution over treatment course
Data Presentation Example
Baseline Characteristics Table
Characteristic Mesenchymal-IA (n=18) Other (n=42) p-value
Age, years (median [IQR]) 64 [56-71] 61 [53-68] 0.42
Sex, n (%)
Male 11 (61%) 24 (57%) 0.78
Female 7 (39%) 18 (43%)
ECOG PS, n (%)
0-1 15 (83%) 37 (88%) 0.63
2 3 (17%) 5 (12%)
Tumor location
Frontal 4 (22%) 15 (36%) 0.35
Temporal 10 (56%) 16 (38%)
Parietal/Occipital 4 (22%) 11 (26%)
Extent of resection
Gross total 8 (44%) 22 (52%) 0.58
Subtotal 10 (56%) 20 (48%)
MGMT promoter methylated 5 (28%) 18 (43%) 0.27Survival Outcomes Summary
Endpoint Mesenchymal-IA Other HR (95% CI) p-value
Median PFS, months (95% CI) 7.2 (5.8-9.1) 9.5 (8.1-11.3) 1.58 (0.89-2.81) 0.12
6-month PFS rate 61% 74%
Median OS, months (95% CI) 12.8 (10.2-15.4) 16.3 (14.7-18.9) 1.72 (0.95-3.11) 0.073
12-month OS rate 55% 68%
24-month OS rate 17% 31%Key Takeaways
1. Molecular heterogeneity exists in GBM with distinct subtypes 2. Mesenchymal-immune-active subtype characterized by NF1 alterations, immune infiltration 3. Trend toward worse prognosis but not statistically significant (power limitations) 4. Potential bevacizumab benefit hypothesis-generating, requires prospective validation 5. Immunotherapy target: High immune infiltration rational for checkpoint inhibitor trials 6. Clinical implementation pending: Need prospective validation before routine subtyping
References
1. Verhaak RG, et al. Integrated genomic analysis identifies clinically relevant subtypes of glioblastoma characterized by abnormalities in PDGFRA, IDH1, EGFR, and NF1. Cancer Cell. 2010;17(1):98-110. 2. Wang Q, et al. Tumor Evolution of Glioma-Intrinsic Gene Expression Subtypes Associates with Immunological Changes in the Microenvironment. Cancer Cell. 2017;32(1):42-56. 3. Stupp R, et al. Radiotherapy plus Concomitant and Adjuvant Temozolomide for Glioblastoma. NEJM. 2005;352(10):987-996. 4. Gilbert MR, et al. Bevacizumab for Newly Diagnosed Glioblastoma. NEJM. 2014;370(8):699-708. 5. NCCN Clinical Practice Guidelines in Oncology: Central Nervous System Cancers. Version 1.2024.
---
This example demonstrates:
- Biomarker-based stratification methodology
- Outcome reporting with appropriate statistics
- Clinical contextualization of findings
- Evidence-based recommendations with grading
- Transparent limitation discussion
- Structure suitable for pharmaceutical/clinical research documentation
Recommendation Strength Guide
GRADE Framework for Clinical Recommendations
Components of a Recommendation
Every clinical recommendation should address:
1. Population: Who should receive the intervention? 2. Intervention: What specific treatment/action? 3. Comparator: Compared to what alternative? 4. Outcome: What are the expected results? 5. Strength: How strong is the recommendation? 6. Quality of Evidence: How confident are we in the evidence?
Recommendation Strength (Grade 1 vs Grade 2)
Strong Recommendation (Grade 1)
When to Use:
- Desirable effects clearly outweigh undesirable effects (or vice versa)
- High or moderate quality evidence
- Values and preferences: Little variability expected
- Resource implications: Cost-effective or cost considerations minor
Wording: "We recommend..." or "Clinicians should..."
Implications:
- Most patients should receive the recommended intervention
- Adherence to recommendation could be a quality indicator
- Policy-makers can adapt as performance measure
Examples:
STRONG RECOMMENDATION FOR (Grade 1):
"We recommend osimertinib 80 mg daily as first-line therapy for adults with
advanced NSCLC harboring EGFR exon 19 deletion or L858R mutation (Strong
recommendation, High-quality evidence - GRADE 1A)."
Rationale:
- Large PFS benefit: 18.9 vs 10.2 months (HR 0.46, p<0.001)
- OS benefit: 38.6 vs 31.8 months (HR 0.80, p=0.046)
- Better tolerability: Lower grade 3-4 AEs
- Evidence: High-quality (large RCT, low risk of bias)
- Benefits clearly outweigh harmsSTRONG RECOMMENDATION AGAINST (Grade 1):
"We recommend against using bevacizumab in the first-line treatment of newly
diagnosed glioblastoma to improve overall survival (Strong recommendation against,
High-quality evidence - GRADE 1A)."
Rationale:
- No OS benefit: HR 0.88 (0.76-1.02), p=0.10 (AVAglio trial)
- Toxicity: Increased grade ≥3 AEs (66% vs 52%)
- Evidence: High-quality (two large phase 3 RCTs)
- Harms outweigh lack of survival benefitConditional/Weak Recommendation (Grade 2)
When to Use:
- Desirable and undesirable effects closely balanced
- Low or very low quality evidence
- Values and preferences: Substantial variability
- Resource implications: High cost or limited access
Wording: "We suggest..." or "Clinicians might..."
Implications:
- Different choices will be appropriate for different patients
- Shared decision-making essential
- Policy-making requires substantial debate and stakeholder involvement
Examples:
CONDITIONAL RECOMMENDATION FOR (Grade 2):
"We suggest considering maintenance pemetrexed after first-line platinum-pemetrexed
chemotherapy for advanced non-squamous NSCLC in patients without disease progression
(Conditional recommendation, Moderate-quality evidence - GRADE 2B)."
Rationale:
- Modest PFS benefit: 4.0 vs 2.0 months (HR 0.62)
- No OS benefit: 13.9 vs 11.0 months (HR 0.79, p=0.23)
- Toxicity: Continued chemotherapy burden
- Quality of life: Trade-off between symptom control and treatment side effects
- Patient values: Some prioritize time off treatment, others prioritize disease control
- Shared decision-making essentialCONDITIONAL RECOMMENDATION - EITHER OPTION ACCEPTABLE (Grade 2):
"We suggest either pembrolizumab monotherapy OR pembrolizumab plus platinum-doublet
chemotherapy as first-line treatment for PD-L1 ≥50% NSCLC, based on patient
preferences and clinical factors (Conditional recommendation, High-quality evidence -
GRADE 2A)."
Rationale:
- Both regimens NCCN Category 1 preferred
- Monotherapy: Less toxicity, oral vs IV, better quality of life
- Combination: Higher ORR (48% vs 39%), numerically longer PFS
- OS: Similar between strategies
- Patient values: Varies widely (tolerability vs response rate priority)Evidence Quality (⊕⊕⊕⊕ to ⊕○○○)
High Quality (⊕⊕⊕⊕)
- Further research very unlikely to change confidence in effect estimate
- Consistent results from well-designed RCTs
- No serious limitations
- Direct evidence (target population, intervention, outcomes)
- Precise estimate (narrow CI)
Example: FLAURA trial for osimertinib in EGFR+ NSCLC - Large RCT, consistent results, low risk of bias, direct outcomes
Moderate Quality (⊕⊕⊕○)
- Further research likely to impact confidence and may change estimate
- RCTs with some limitations OR very strong evidence from observational studies
- Some inconsistency, indirectness, imprecision, or publication bias
Example: Single RCT with some limitations, or multiple RCTs with moderate heterogeneity
Low Quality (⊕⊕○○)
- Further research very likely to have important impact on confidence in estimate
- Observational studies OR RCTs with serious limitations
- Serious issues with consistency, directness, precision, or bias
Example: Well-conducted cohort study, or RCT with high attrition and unclear allocation concealment
Very Low Quality (⊕○○○)
- Estimate of effect very uncertain
- Case series, expert opinion, mechanistic reasoning
- Very serious limitations
Example: Retrospective case series, expert consensus without systematic review
Combining Strength and Quality
All Nine Possible Combinations
| Evidence Quality | Strong For (↑↑) | Weak For (↑) | Strong Against (↓↓) | Weak Against (↓) |
|---|---|---|---|---|
| High (⊕⊕⊕⊕) | Grade 1A | Grade 2A | Grade 1A (against) | Grade 2A (against) |
| Moderate (⊕⊕⊕○) | Grade 1B | Grade 2B | Grade 1B (against) | Grade 2B (against) |
| Low (⊕⊕○○) | Grade 1C* | Grade 2C | Grade 1C (against)* | Grade 2C (against) |
| Very Low (⊕○○○) | Grade 1D* | Grade 2D | Grade 1D (against)* | Grade 2D (against) |
*Rare: Strong recommendations usually require at least moderate-quality evidence
Unusual Combinations (When They Occur)
Strong Recommendation with Low Quality Evidence (Grade 1C)
Rare, but can occur when:
- Large magnitude of effect from observational data (RR >5 or <0.2)
- Low quality evidence, but clear benefit-harm balance
- Example: Anticoagulation for atrial fibrillation (before RCTs, strong observational data)
Weak Recommendation with High Quality Evidence (Grade 2A)
Occurs when:
- Benefits and harms closely balanced
- Patient values highly variable
- Example: Aspirin for primary prevention in low-risk individuals (benefits small, bleeding risk present, patient values vary)
Wording Templates
Strong Recommendations
FOR (↑↑):
- "We recommend [intervention] for [population]."
- "Clinicians should [action]."
- "[Intervention] is recommended."
AGAINST (↓↓):
- "We recommend against [intervention] for [population]."
- "Clinicians should not [action]."
- "[Intervention] is not recommended."
Conditional/Weak Recommendations
FOR (↑):
- "We suggest [intervention] for [population]."
- "Clinicians might consider [action]."
- "[Intervention] may be considered for selected patients."
AGAINST (↓):
- "We suggest not using [intervention] for [population]."
- "Clinicians might avoid [action]."
- "[Intervention] is generally not recommended."
EITHER ACCEPTABLE:
- "We suggest either [option A] or [option B] based on patient preferences."
- "Either approach is reasonable."
Color Coding for Visual Documents
Strong Recommendations (Green Background):
- RGB(0, 153, 76) or #009954
- Clear visual priority
- Use for Grade 1A, 1B
Conditional Recommendations (Yellow Background):
- RGB(255, 193, 7) or #FFC107
- Indicates discussion needed
- Use for Grade 2A, 2B, 2C
Research/Investigational (Blue Background):
- RGB(33, 150, 243) or #2196F3
- Clinical trial consideration
- Insufficient evidence for standard care
Not Recommended (Red Border/Background):
- RGB(220, 20, 60) or #DC143C
- Strong recommendation against
- Evidence of harm or no benefit
Common Scenarios
Scenario 1: Strong Evidence, Clear Benefit-Harm Balance
Example: Pembrolizumab for PD-L1 ≥50% NSCLC
- Evidence: Large phase 3 RCT (KEYNOTE-024), n=305, well-designed
- Results: PFS HR 0.50 (0.37-0.68), OS HR 0.60 (0.41-0.89)
- Toxicity: Lower grade 3-5 AEs than chemotherapy (27% vs 53%)
- Patient values: Most prioritize efficacy and tolerability
Recommendation: STRONG FOR (Grade 1A)
Scenario 2: Moderate Evidence, Balanced Trade-Offs
Example: Adjuvant immunotherapy for resected melanoma
- Evidence: RCT showing relapse-free survival benefit, OS data immature
- Results: Recurrence risk reduced but ongoing toxicity
- Toxicity: Immune-related AEs requiring steroids (some severe)
- Cost: High annual cost for 12 months treatment
- Patient values: Variable (some prioritize recurrence prevention, others avoid toxicity)
Recommendation: CONDITIONAL FOR (Grade 2B)
Scenario 3: Low Evidence, but Severe Consequence
Example: Anticoagulation for prosthetic heart valve
- Evidence: No RCTs (would be unethical), observational data and mechanistic reasoning
- Consequence: Very high thromboembolic risk without anticoagulation
- Benefit-harm: Clear despite low quality evidence
Recommendation: STRONG FOR (Grade 1C)
Scenario 4: High Evidence, but Patient Preferences Vary
Example: Breast reconstruction after mastectomy
- Evidence: High-quality data on outcomes and satisfaction
- Trade-offs: Cosmetic benefit vs additional surgery, recovery time
- Values: Highly personal decision, wide preference variability
Recommendation: CONDITIONAL (Grade 2A) - discuss options, patient decides
Documentation Template
RECOMMENDATION: [State recommendation clearly]
Strength: [STRONG / CONDITIONAL]
Quality of Evidence: [HIGH / MODERATE / LOW / VERY LOW]
GRADE: [1A / 1B / 2A / 2B / 2C]
Evidence Summary:
- Primary study: [Citation]
- Design: [RCT / Observational / Meta-analysis]
- Sample size: n = [X]
- Results: [Primary outcome with effect size, CI, p-value]
- Quality assessment: [Strengths and limitations]
Benefits:
- [Quantified benefit 1]
- [Quantified benefit 2]
Harms:
- [Quantified harm 1]
- [Quantified harm 2]
Balance: [Benefits clearly outweigh harms / Close balance requiring discussion / etc.]
Values and Preferences: [Little variability / Substantial variability]
Cost Considerations: [If relevant]
Guideline Concordance:
- NCCN: [Category and recommendation]
- ASCO: [Recommendation]
- ESMO: [Grade and recommendation]Quality Checklist
Before finalizing recommendations, verify:
- [ ] Recommendation statement is clear and actionable
- [ ] Strength is explicitly stated (strong vs conditional)
- [ ] Quality of evidence is graded (high/moderate/low/very low)
- [ ] GRADE notation provided (1A, 1B, 2A, 2B, 2C)
- [ ] Evidence is cited with specific study results
- [ ] Benefits are quantified (effect sizes with CIs)
- [ ] Harms are quantified (AE rates)
- [ ] Balance of benefits/harms is explained
- [ ] Patient values consideration is addressed (if conditional)
- [ ] Alternative options are mentioned
- [ ] Guideline concordance is documented
- [ ] Special populations are addressed (elderly, renal/hepatic impairment)
- [ ] Monitoring requirements are specified
\documentclass[10pt,letterpaper]{article}
% Packages
\usepackage[margin=0.5in]{geometry}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{helvet}
\renewcommand{\familydefault}{\sfdefault}
\usepackage{xcolor}
\usepackage{tcolorbox}
\usepackage{array}
\usepackage{tabularx}
\usepackage{booktabs}
\usepackage{enumitem}
\usepackage{titlesec}
\usepackage{fancyhdr}
\usepackage{multicol}
\usepackage{graphicx}
\usepackage{tikz}
\usetikzlibrary{shapes,arrows,positioning}
% Color definitions
\definecolor{headerblue}{RGB}{0,102,204}
\definecolor{stronggreen}{RGB}{0,153,76}
\definecolor{conditionalyellow}{RGB}{255,193,7}
\definecolor{researchblue}{RGB}{33,150,243}
\definecolor{warningred}{RGB}{204,0,0}
\definecolor{highlightgray}{RGB}{240,240,240}
% Section formatting - compact
\titleformat{\section}{\normalfont\fontsize{11}{12}\bfseries\color{headerblue}}{\thesection}{0.5em}{}
\titlespacing*{\section}{0pt}{4pt}{2pt}
\titleformat{\subsection}{\normalfont\fontsize{10}{11}\bfseries}{\thesubsection}{0.5em}{}
\titlespacing*{\subsection}{0pt}{3pt}{1pt}
% List formatting - ultra compact
\setlist[itemize]{leftmargin=*,itemsep=0pt,parsep=0pt,topsep=1pt}
\setlist[enumerate]{leftmargin=*,itemsep=0pt,parsep=0pt,topsep=1pt}
% Remove paragraph indentation
\setlength{\parindent}{0pt}
\setlength{\parskip}{2pt}
% Header/footer
\pagestyle{fancy}
\fancyhf{}
\fancyhead[L]{\footnotesize \textbf{Treatment Recommendations: [CONDITION]}}
\fancyhead[R]{\footnotesize Page \thepage}
\renewcommand{\headrulewidth}{0.5pt}
\fancyfoot[C]{\footnotesize Evidence-Based Clinical Guideline - For Professional Use Only}
\begin{document}
% Title block
\begin{center}
{\fontsize{14}{16}\selectfont\bfseries\color{headerblue} EVIDENCE-BASED TREATMENT RECOMMENDATIONS}\\[2pt]
{\fontsize{12}{14}\selectfont\bfseries [Disease/Condition - e.g., HER2+ Metastatic Breast Cancer]}\\[2pt]
{\fontsize{10}{12}\selectfont [Institution/Organization]}\\[1pt]
{\fontsize{9}{11}\selectfont Version X.X | Effective Date: [Date] | Next Review: [Date]}
\end{center}
\vspace{4pt}
% Recommendation Strength Legend
\begin{tcolorbox}[colback=highlightgray,colframe=black,title=\textbf{Recommendation Strength Key},fonttitle=\bfseries\small,coltitle=black]
{\small
\begin{itemize}
\item \colorbox{stronggreen!30}{\textbf{STRONG (Grade 1)}} - Benefits clearly outweigh risks; most patients should receive intervention
\item \colorbox{conditionalyellow!30}{\textbf{CONDITIONAL (Grade 2)}} - Trade-offs exist; shared decision-making essential
\item \colorbox{researchblue!30}{\textbf{RESEARCH (Grade R)}} - Insufficient evidence; clinical trial enrollment preferred
\end{itemize}
\textbf{Evidence Quality}: \textbf{A} = High (RCTs), \textbf{B} = Moderate (RCTs with limitations), \textbf{C} = Low (observational), \textbf{D} = Very low (expert opinion)
}
\end{tcolorbox}
\vspace{2pt}
\section{Clinical Context}
\subsection{Disease Overview}
[Brief description of disease state, epidemiology, natural history]
\subsection{Patient Population}
\textbf{Target Population}:
\begin{itemize}
\item [Demographic characteristics - e.g., Adults $\geq$18 years]
\item [Disease stage/severity - e.g., Metastatic disease, Stage IV]
\item [Biomarker status - e.g., HER2-positive (IHC 3+ or FISH+)]
\item [Performance status - e.g., ECOG 0-2]
\item [Line of therapy - e.g., First-line, previously untreated]
\end{itemize}
\textbf{Exclusions}:
\begin{itemize}
\item [Contraindications to recommended therapies]
\item [Comorbidities affecting eligibility]
\end{itemize}
\section{Evidence Review}
\subsection{Key Clinical Trials}
\textbf{[Trial Name 1]} (Author, Journal Year):
\begin{itemize}
\item \textbf{Design}: Phase 3 RCT, n=XXX, [Treatment A] vs [Treatment B]
\item \textbf{Population}: [Key eligibility criteria]
\item \textbf{Primary Endpoint}: [Outcome] - XX vs XX months (HR X.XX, 95\% CI X.XX-X.XX, p<X.XXX)
\item \textbf{Secondary Endpoints}: [Additional outcomes]
\item \textbf{Safety}: Grade 3-4 AEs XX\% vs XX\%
\item \textbf{Quality}: \textbf{High} (low risk of bias, adequate power, intention-to-treat analysis)
\end{itemize}
\textbf{[Trial Name 2]} (Author, Journal Year):
\begin{itemize}
\item \textbf{Design}: Phase 3 RCT, n=XXX, [Treatment C] vs [Standard of care]
\item \textbf{Primary Endpoint}: [Outcome and results]
\item \textbf{Quality}: \textbf{Moderate} (some limitations)
\end{itemize}
\subsection{Guideline Concordance}
\begin{table}[H]
\centering
\small
\begin{tabular}{lll}
\toprule
\textbf{Guideline} & \textbf{Recommendation} & \textbf{Evidence Level} \\
\midrule
NCCN vX.XXXX & [Specific recommendation] & Category 1 (preferred) \\
ASCO Year & [Recommendation] & Strong, Evidence A \\
ESMO Year & [Recommendation] & Grade I, A \\
\bottomrule
\end{tabular}
\caption{Major guideline recommendations}
\end{table}
\section{Treatment Options}
\subsection{First-Line Therapy}
\begin{tcolorbox}[enhanced,colback=stronggreen!10,colframe=stronggreen,
title={\textbf{Option 1: [Regimen Name]} \hfill \colorbox{white}{\textbf{STRONG (1A)}}},
fonttitle=\bfseries\small,coltitle=black]
{\small
\textbf{Regimen}:
\begin{itemize}
\item [Drug A]: XX mg [IV/PO] [schedule]
\item [Drug B]: XX mg [IV/PO] [schedule]
\item Cycle length: XX days
\item Duration: Until progression or unacceptable toxicity
\end{itemize}
\textbf{Evidence Basis}:
\begin{itemize}
\item Primary study: [Trial name], n=XXX
\item Primary outcome: [Endpoint] XX vs XX months (HR X.XX, p<X.XXX)
\item ORR: XX\% vs XX\% (control)
\end{itemize}
\textbf{Indications}:
\begin{itemize}
\item [Biomarker-defined population or all patients]
\item [Performance status requirement]
\item [Organ function requirements]
\end{itemize}
\textbf{Key Toxicities}:
\begin{itemize}
\item Grade 3-4 AEs: XX\%
\item Common: [List 3-5 most common AEs with incidence]
\item Serious: [SAEs, discontinuation rate]
\item Management: [Key mitigation strategies]
\end{itemize}
\textbf{Monitoring}:
\begin{itemize}
\item Labs: [Specific tests, frequency]
\item Imaging: Every [X weeks] (RECIST v1.1)
\item Clinical assessment: Every cycle
\end{itemize}
\textbf{Recommendation Strength}: \textbf{STRONG} - Benefits clearly outweigh risks\\
\textbf{Evidence Quality}: \textbf{HIGH} - Well-designed RCT with consistent results
}
\end{tcolorbox}
\vspace{3pt}
\begin{tcolorbox}[enhanced,colback=conditionalyellow!10,colframe=conditionalyellow,
title={\textbf{Option 2: [Alternative Regimen]} \hfill \colorbox{white}{\textbf{CONDITIONAL (2B)}}},
fonttitle=\bfseries\small,coltitle=black]
{\small
\textbf{Regimen}: [Dosing details]
\textbf{Evidence Basis}: [Moderate-quality evidence or specific population subset]
\textbf{Indications}: [When to consider this option - e.g., patient preference for oral therapy, specific contraindication to Option 1]
\textbf{Trade-offs}:
\begin{itemize}
\item Advantages: [e.g., Oral administration, better tolerability]
\item Disadvantages: [e.g., Lower response rate, less survival benefit]
\end{itemize}
\textbf{Recommendation Strength}: \textbf{CONDITIONAL} - Patient values important in decision\\
\textbf{Evidence Quality}: \textbf{MODERATE} - Some limitations in evidence base
}
\end{tcolorbox}
\vspace{3pt}
\begin{tcolorbox}[enhanced,colback=researchblue!10,colframe=researchblue,
title={\textbf{Option 3: Clinical Trial} \hfill \colorbox{white}{\textbf{RESEARCH (R)}}},
fonttitle=\bfseries\small,coltitle=black]
{\small
\textbf{Recommendation}: Consider clinical trial enrollment for [specific scenario - e.g., biomarker-selected patients, refractory disease]
\textbf{Available Trials}: [List relevant trials if known, or state "ClinicalTrials.gov search"]
\textbf{Rationale}: [Why clinical trial appropriate - e.g., novel mechanism, unmet medical need, investigational biomarker]
}
\end{tcolorbox}
\subsection{Second-Line and Beyond}
\textbf{At Progression on First-Line Therapy}:
\begin{itemize}
\item \textbf{Biomarker Re-Testing}: [If applicable - e.g., liquid biopsy for resistance mutations]
\item \textbf{Second-Line Options}:
\begin{itemize}
\item Preferred: [Regimen] (Evidence level)
\item Alternative: [Regimen] (Evidence level)
\end{itemize}
\item \textbf{Third-Line Options}: [Subsequent therapy options]
\end{itemize}
\section{Special Populations}
\subsection{Elderly Patients ($\geq$70 years)}
\textbf{Considerations}:
\begin{itemize}
\item Geriatric assessment recommended (G8 screening tool)
\item Dose reductions: [Specific adjustments for frail patients]
\item Monitoring: More frequent assessments for toxicity
\end{itemize}
\textbf{Regimen Modifications}:
\begin{itemize}
\item [Reduced-intensity regimens if appropriate]
\item [Single-agent vs combination considerations]
\end{itemize}
\subsection{Renal Impairment}
\begin{table}[H]
\centering
\footnotesize
\begin{tabular}{lll}
\toprule
\textbf{eGFR (mL/min/1.73m²)} & \textbf{Category} & \textbf{Dose Adjustment} \\
\midrule
$\geq$60 & Normal/Mild & Standard dosing \\
30-59 & Moderate & [Specific adjustment - e.g., Reduce 25\%] \\
15-29 & Severe & [Specific adjustment - e.g., Reduce 50\% or avoid] \\
<15 or dialysis & ESRD & [Use with caution or contraindicated] \\
\bottomrule
\end{tabular}
\caption{Dose adjustments for renal impairment}
\end{table}
\subsection{Hepatic Impairment}
[Similar table for hepatic dose adjustments using Child-Pugh class or bilirubin/transaminases]
\section{Clinical Decision Algorithm}
% Simple flowchart example - can be expanded with more complex TikZ
\begin{center}
\begin{tikzpicture}[node distance=1.8cm, auto,
decision/.style={diamond, draw, fill=conditionalyellow!30, text width=4.5em, text centered, inner sep=1pt, font=\tiny},
process/.style={rectangle, draw, fill=stronggreen!20, text width=5.5em, text centered, rounded corners, minimum height=2em, font=\tiny},
terminal/.style={rectangle, draw, fill=highlightgray, text width=5.5em, text centered, rounded corners=6pt, minimum height=2em, font=\tiny},
alert/.style={rectangle, draw=warningred, line width=1pt, fill=warningred!10, text width=5.5em, text centered, rounded corners, minimum height=2em, font=\tiny\bfseries},
arrow/.style={thick,->,>=stealth}]
\node [terminal] (start) {[Disease] Diagnosis Confirmed};
\node [decision, below of=start, node distance=1.8cm] (biomarker) {Biomarker\\ Positive?};
\node [process, left of=biomarker, node distance=3.5cm] (optionA) {Targeted\\ Therapy};
\node [process, right of=biomarker, node distance=3.5cm] (optionB) {Standard\\ Therapy};
\node [terminal, below of=biomarker, node distance=2.5cm] (monitor) {Monitor Response\\ Every X weeks};
\draw [arrow] (start) -- (biomarker);
\draw [arrow] (biomarker) -- node[above] {Yes} (optionA);
\draw [arrow] (biomarker) -- node[above] {No} (optionB);
\draw [arrow] (optionA) |- (monitor);
\draw [arrow] (optionB) |- (monitor);
\end{tikzpicture}
\end{center}
{\footnotesize \textit{Figure 1: Simplified treatment selection algorithm. See detailed algorithm in references for complete decision pathway.}}
\section{Monitoring Protocol}
\subsection{On-Treatment Monitoring}
\begin{table}[H]
\centering
\footnotesize
\begin{tabular}{lccl}
\toprule
\textbf{Assessment} & \textbf{Baseline} & \textbf{Frequency} & \textbf{Rationale} \\
\midrule
CBC with differential & $\checkmark$ & Before each cycle & Myelosuppression \\
Comprehensive metabolic panel & $\checkmark$ & Before each cycle & Organ function \\
[Specific biomarker] & $\checkmark$ & Every X cycles & [Reason] \\
Imaging (CT chest/abd/pelvis) & $\checkmark$ & Every X weeks & Response assessment \\
ECOG performance status & $\checkmark$ & Every visit & Functional status \\
Toxicity assessment (CTCAE) & - & Every visit & Safety monitoring \\
\bottomrule
\end{tabular}
\caption{Recommended monitoring schedule}
\end{table}
\subsection{Dose Modification Guidelines}
\textbf{Hematologic Toxicity}:
\begin{itemize}
\item \textbf{ANC <1.0 or Platelets <75k}: Delay treatment, recheck weekly, dose reduce 20\% when recovered
\item \textbf{ANC <0.5 or Platelets <50k}: Hold treatment, G-CSF support, dose reduce 25-40\%
\item \textbf{Febrile neutropenia}: Hold, hospitalize, antibiotics, dose reduce 25\% when recovered
\end{itemize}
\textbf{Non-Hematologic Toxicity}:
\begin{itemize}
\item \textbf{Grade 2}: Continue with supportive care, consider dose modification if persistent
\item \textbf{Grade 3}: Hold until $\leq$Grade 1, resume at reduced dose (20-25\% reduction)
\item \textbf{Grade 4}: Discontinue treatment or hold pending recovery (case-by-case)
\end{itemize}
\textbf{Specific Toxicity Management}:
\begin{itemize}
\item \textbf{[Specific AE]}: [Management approach - e.g., Diarrhea Grade 3: Hold treatment, loperamide, hydration, resume at reduced dose when $\leq$Grade 1]
\item \textbf{[Immune-related AE]}: [Management - e.g., Pneumonitis Grade 2+: Hold immunotherapy, corticosteroids, pulmonology consultation]
\end{itemize}
\section{Treatment Recommendations by Clinical Scenario}
\subsection{Scenario 1: [Specific Clinical Situation]}
\begin{tcolorbox}[enhanced,colback=stronggreen!10,colframe=stronggreen,
title={\textbf{RECOMMENDATION} \hfill \textbf{GRADE: 1A}},
fonttitle=\bfseries\small,coltitle=black]
{\small
\textbf{We recommend} [specific intervention] for [patient population].
\textbf{Evidence}:
\begin{itemize}
\item [Primary supporting evidence with results]
\item [Guideline concordance - NCCN, ASCO, ESMO]
\end{itemize}
\textbf{Benefits}: [Quantified improvements - e.g., 8.7-month PFS benefit, HR 0.46]
\textbf{Harms}: [Quantified risks - e.g., 15\% grade 3-4 immune-related AEs]
\textbf{Balance}: Benefits clearly outweigh harms for most patients
}
\end{tcolorbox}
\subsection{Scenario 2: [Alternative Clinical Situation]}
\begin{tcolorbox}[enhanced,colback=conditionalyellow!10,colframe=conditionalyellow,
title={\textbf{RECOMMENDATION} \hfill \textbf{GRADE: 2B}},
fonttitle=\bfseries\small,coltitle=black]
{\small
\textbf{We suggest} [intervention] for [patient population] who value [specific outcome].
\textbf{Evidence}: [Moderate-quality evidence summary]
\textbf{Trade-offs}:
\begin{itemize}
\item \textbf{Advantages}: [e.g., Oral administration, less frequent monitoring]
\item \textbf{Disadvantages}: [e.g., Lower response rate, more out-of-pocket cost]
\end{itemize}
\textbf{Patient Values}: Substantial variability in how patients value outcomes; shared decision-making essential
}
\end{tcolorbox}
\section{Alternative Approaches}
\subsection{Non-Recommended Options}
\begin{tcolorbox}[enhanced,colback=warningred!10,colframe=warningred,
title={\textbf{NOT RECOMMENDED}},
fonttitle=\bfseries\small,coltitle=white,colbacktitle=warningred]
{\small
\textbf{[Intervention X]} is \textbf{not recommended} for [population].
\textbf{Reason}: [Evidence of harm, lack of benefit, or superior alternatives available]
\textbf{Evidence}: [Supporting data showing no benefit or harm]
}
\end{tcolorbox}
\section{Supportive Care}
\subsection{Symptom Management}
\begin{itemize}
\item \textbf{Pain Control}: [Analgesic recommendations, WHO ladder]
\item \textbf{Nausea Prevention}: [Antiemetics - e.g., 5-HT3 antagonists, NK1 antagonists for highly emetogenic]
\item \textbf{Bone Health}: [e.g., Bisphosphonates or denosumab if bone metastases]
\item \textbf{Nutritional Support}: [Consult if weight loss >5\%, cachexia management]
\item \textbf{Psychosocial Support}: [Depression screening, support groups, palliative care early integration]
\end{itemize}
\subsection{Growth Factor Support}
\textbf{G-CSF Prophylaxis}:
\begin{itemize}
\item \textbf{Primary prophylaxis}: If febrile neutropenia risk $\geq$20\%
\item \textbf{Secondary prophylaxis}: After prior febrile neutropenia episode
\item Agent: [Pegfilgrastim 6 mg SC day 2 or filgrastim 5 mcg/kg SC daily days 3-10]
\end{itemize}
\section{Follow-Up and Surveillance}
\subsection{During Active Treatment}
[Schedule outlined in Monitoring Protocol section above]
\subsection{Post-Treatment Surveillance}
\begin{table}[H]
\centering
\footnotesize
\begin{tabular}{lccc}
\toprule
\textbf{Time Period} & \textbf{Imaging} & \textbf{Labs} & \textbf{Clinical Visits} \\
\midrule
Year 1 & Every 3 months & Every 3 months & Every 3 months \\
Year 2 & Every 3-4 months & Every 3-4 months & Every 3-4 months \\
Years 3-5 & Every 6 months & Every 6 months & Every 6 months \\
Year 5+ & Annually & Annually & Annually \\
\bottomrule
\end{tabular}
\caption{Post-treatment surveillance schedule (adjust based on risk of recurrence)}
\end{table}
\section{Clinical Trial Opportunities}
\textbf{When to Consider Clinical Trials}:
\begin{itemize}
\item After progression on standard therapies
\item High-risk disease with poor prognosis on standard therapy
\item Novel biomarker potentially predictive of response
\item Patient preference for investigational approach
\end{itemize}
\textbf{Resources}:
\begin{itemize}
\item ClinicalTrials.gov search: [Specific keywords]
\item [Institution] clinical trials office: [Contact information]
\end{itemize}
\section{Shared Decision-Making}
\subsection{Key Discussion Points}
\textbf{Goals of Care}:
\begin{itemize}
\item Curative intent vs prolonged disease control vs palliation
\item Quality of life vs quantity of life trade-offs
\item Functional independence goals
\end{itemize}
\textbf{Treatment Options Counseling}:
\begin{itemize}
\item Expected benefits (median survival, response rates)
\item Potential harms (toxicity profile, quality of life impact)
\item Treatment schedule and logistics (frequency of visits, IV vs oral)
\item Financial considerations (out-of-pocket costs, time off work)
\end{itemize}
\textbf{Decision Aids}:
\begin{itemize}
\item Number Needed to Treat: [e.g., Treat X patients to prevent 1 progression event]
\item Survival benefit visualization: [X-month improvement in median survival]
\end{itemize}
\section{References}
\begin{enumerate}
\item [Primary clinical trial reference]
\item [Secondary supporting trial]
\item [NCCN Guidelines, version]
\item [ASCO/ESMO Guideline reference]
\item [Meta-analysis or systematic review if applicable]
\item [Biomarker validation reference]
\end{enumerate}
\vspace{10pt}
\hrule
\vspace{4pt}
{\footnotesize
\textbf{Guideline Development Committee}:\\
[Names and titles of committee members, affiliations]
\textbf{Evidence Review Date}: [Date]\\
\textbf{Guideline Effective Date}: [Date]\\
\textbf{Next Scheduled Review}: [Date] (or earlier if practice-changing evidence published)
\textbf{Conflicts of Interest}: [None / See disclosure statements]
\textbf{Methodology}: GRADE framework for evidence evaluation and recommendation development. Systematic literature review conducted [date range]. Guidelines concordance checked with NCCN, ASCO, ESMO current versions.
\textbf{For Questions}: Contact [Name], [Title] at [Email/Phone]
}
\end{document}
Clinical Decision Algorithms Guide
Overview
Clinical decision algorithms provide systematic, step-by-step guidance for diagnosis, treatment selection, and patient management. This guide covers algorithm development, validation, and visual presentation using decision trees and flowcharts.
Algorithm Design Principles
Key Components
Decision Nodes
- Question/Criteria: Clear, measurable clinical parameter
- Binary vs Multi-Way: Yes/no (simple) vs multiple options (complex)
- Objective: Lab value, imaging finding vs Subjective: Clinical judgment
Action Nodes
- Treatment: Specific intervention with dosing
- Test: Additional diagnostic procedure
- Referral: Specialist consultation, higher level of care
- Observation: Watchful waiting with defined follow-up
Terminal Nodes
- Outcome: Final decision point
- Follow-up: Schedule for reassessment
- Exit criteria: When to exit algorithm
Design Criteria
Clarity
- Unambiguous decision points
- Mutually exclusive pathways
- No circular loops (unless intentional reassessment cycles)
- Clear entry and exit points
Clinical Validity
- Evidence-based decision criteria
- Validated cut-points for biomarkers
- Guideline-concordant recommendations
- Expert consensus where evidence limited
Usability
- Maximum 7 decision points per pathway (cognitive load)
- Visual hierarchy (most common path highlighted)
- Printable single-page format preferred
- Color coding for urgency/safety
Completeness
- All possible scenarios covered
- Default pathway for edge cases
- Safety-net provisions for unusual presentations
- Escalation criteria clearly stated
Clinical Decision Trees
Diagnostic Algorithms
Chest Pain Evaluation Algorithm
Entry: Patient with chest pain
├─ STEMI Criteria? (ST elevation ≥1mm in ≥2 contiguous leads)
│ ├─ YES → Activate cath lab, aspirin 325mg, heparin, clopidogrel 600mg
│ │ Transfer for primary PCI (goal door-to-balloon <90 minutes)
│ └─ NO → Continue evaluation
├─ High-Risk Features? (Hemodynamic instability, arrhythmia, troponin elevation)
│ ├─ YES → Admit CCU, serial troponins, cardiology consultation
│ │ Consider early angiography if NSTEMI
│ └─ NO → Calculate TIMI or HEART score
├─ TIMI Score 0-1 or HEART Score 0-3? (Low risk)
│ ├─ YES → Observe 6-12 hours, serial troponins, stress test if negative
│ │ Discharge if all negative with cardiology follow-up in 72 hours
│ └─ NO → TIMI 2-4 or HEART 4-6 (Intermediate risk)
├─ TIMI Score 2-4 or HEART Score 4-6? (Intermediate risk)
│ ├─ YES → Admit telemetry, serial troponins, stress imaging vs CT angiography
│ │ Medical management: Aspirin, statin, beta-blocker
│ └─ NO → TIMI ≥5 or HEART ≥7 (High risk) → Treat as NSTEMI
Decision Endpoint: Risk-stratified pathway with 30-day event rate documentedPulmonary Embolism Diagnostic Algorithm (Wells Criteria)
Entry: Suspected PE
Step 1: Calculate Wells Score
Clinical features points:
- Clinical signs of DVT: 3 points
- PE more likely than alternative diagnosis: 3 points
- Heart rate >100: 1.5 points
- Immobilization/surgery in past 4 weeks: 1.5 points
- Previous PE/DVT: 1.5 points
- Hemoptysis: 1 point
- Malignancy: 1 point
Step 2: Risk Stratify
├─ Wells Score ≤4 (PE unlikely)
│ └─ D-dimer test
│ ├─ D-dimer negative (<500 ng/mL) → PE excluded, consider alternative diagnosis
│ └─ D-dimer positive (≥500 ng/mL) → CTPA
│
└─ Wells Score >4 (PE likely)
└─ CTPA (skip D-dimer)
Step 3: CTPA Results
├─ Positive for PE → Risk stratify severity
│ ├─ Massive PE (hypotension, shock) → Thrombolytics vs embolectomy
│ ├─ Submassive PE (RV strain, troponin+) → Admit ICU, consider thrombolytics
│ └─ Low-risk PE → Anticoagulation, consider outpatient management
│
└─ Negative for PE → PE excluded, investigate alternative diagnosis
Step 4: Treatment Decision (if PE confirmed)
├─ Absolute contraindication to anticoagulation?
│ ├─ YES → IVC filter placement, treat underlying condition
│ └─ NO → Anticoagulation therapy
│
├─ Cancer-associated thrombosis?
│ ├─ YES → LMWH preferred (edoxaban alternative)
│ └─ NO → DOAC preferred (apixaban, rivaroxaban, edoxaban)
│
└─ Duration: Minimum 3 months, extended if unprovoked or recurrentTreatment Selection Algorithms
NSCLC First-Line Treatment Algorithm
Entry: Advanced/Metastatic NSCLC, adequate PS (ECOG 0-2)
Step 1: Biomarker Testing Complete?
├─ NO → Reflex testing: EGFR, ALK, ROS1, BRAF, PD-L1, consider NGS
│ Hold systemic therapy pending results (unless rapidly progressive)
└─ YES → Proceed to Step 2
Step 2: Actionable Genomic Alteration?
├─ EGFR exon 19 deletion or L858R → Osimertinib 80mg daily
│ └─ Alternative: Erlotinib, gefitinib, afatinib (less preferred)
│
├─ ALK rearrangement → Alectinib 600mg BID
│ └─ Alternatives: Brigatinib, lorlatinib, crizotinib (less preferred)
│
├─ ROS1 rearrangement → Crizotinib 250mg BID or entrectinib
│
├─ BRAF V600E → Dabrafenib + trametinib
│
├─ MET exon 14 skipping → Capmatinib or tepotinib
│
├─ RET rearrangement → Selpercatinib or pralsetinib
│
├─ NTRK fusion → Larotrectinib or entrectinib
│
├─ KRAS G12C → Sotorasib or adagrasib (if no other options)
│
└─ NO actionable alteration → Proceed to Step 3
Step 3: PD-L1 Testing Result?
├─ PD-L1 ≥50% (TPS)
│ ├─ Option 1: Pembrolizumab 200mg Q3W (monotherapy, NCCN Category 1)
│ ├─ Option 2: Pembrolizumab + platinum doublet chemotherapy
│ └─ Option 3: Atezolizumab + bevacizumab + carboplatin + paclitaxel
│
├─ PD-L1 1-49% (TPS)
│ ├─ Preferred: Pembrolizumab + platinum doublet chemotherapy
│ └─ Alternative: Platinum doublet chemotherapy alone
│
└─ PD-L1 <1% (TPS)
├─ Preferred: Pembrolizumab + platinum doublet chemotherapy
└─ Alternative: Platinum doublet chemotherapy ± bevacizumab
Step 4: Platinum Doublet Selection (if applicable)
├─ Squamous histology
│ └─ Carboplatin AUC 6 + paclitaxel 200 mg/m² Q3W (4 cycles)
│ or Carboplatin AUC 5 + nab-paclitaxel 100 mg/m² D1,8,15 Q4W
│
└─ Non-squamous histology
└─ Carboplatin AUC 6 + pemetrexed 500 mg/m² Q3W (4 cycles)
Continue pemetrexed maintenance if responding
Add bevacizumab 15 mg/kg if eligible (no hemoptysis, brain mets)
Step 5: Monitoring and Response Assessment
- Imaging every 6 weeks for first 12 weeks, then every 9 weeks
- Continue until progression or unacceptable toxicity
- At progression, proceed to second-line algorithmHeart Failure Management Algorithm (AHA/ACC Guidelines)
Entry: Heart Failure Diagnosis Confirmed
Step 1: Determine HF Type
├─ HFrEF (EF ≤40%)
│ └─ Proceed to Guideline-Directed Medical Therapy (GDMT)
│
├─ HFpEF (EF ≥50%)
│ └─ Treat comorbidities, diuretics for congestion, consider SGLT2i
│
└─ HFmrEF (EF 41-49%)
└─ Consider HFrEF GDMT, evidence less robust
Step 2: GDMT for HFrEF (All patients unless contraindicated)
Quadruple Therapy (Class 1 recommendations):
1. ACE Inhibitor/ARB/ARNI
├─ Preferred: Sacubitril-valsartan 49/51mg BID → titrate to 97/103mg BID
│ └─ If ACE-I naïve or taking <10mg enalapril equivalent
├─ Alternative: ACE-I (enalapril, lisinopril, ramipril) to target dose
└─ Alternative: ARB (losartan, valsartan) if ACE-I intolerant
2. Beta-Blocker (start low, titrate slowly)
├─ Bisoprolol 1.25mg daily → 10mg daily target
├─ Metoprolol succinate 12.5mg daily → 200mg daily target
└─ Carvedilol 3.125mg BID → 25mg BID target (50mg BID if >85kg)
3. Mineralocorticoid Receptor Antagonist (MRA)
├─ Spironolactone 12.5-25mg daily → 50mg daily target
└─ Eplerenone 25mg daily → 50mg daily target
└─ Contraindications: K >5.0, CrCl <30 mL/min
4. SGLT2 Inhibitor (regardless of diabetes status)
├─ Dapagliflozin 10mg daily
└─ Empagliflozin 10mg daily
Step 3: Additional Therapies Based on Phenotype
├─ Sinus rhythm + HR ≥70 despite beta-blocker?
│ └─ YES: Add ivabradine 5mg BID → 7.5mg BID target
│
├─ African American + NYHA III-IV?
│ └─ YES: Add hydralazine 37.5mg TID + isosorbide dinitrate 20mg TID
│ (Target: hydralazine 75mg TID + ISDN 40mg TID)
│
├─ Atrial fibrillation?
│ ├─ Rate control (target <80 bpm at rest, <110 bpm with activity)
│ └─ Anticoagulation (DOAC preferred, warfarin if valvular)
│
└─ Iron deficiency (ferritin <100 or <300 with TSAT <20%)?
└─ YES: IV iron supplementation (ferric carboxymaltose)
Step 4: Device Therapy Evaluation
├─ EF ≤35%, NYHA II-III, LBBB with QRS ≥150 ms, sinus rhythm?
│ └─ YES: Cardiac resynchronization therapy (CRT-D)
│
├─ EF ≤35%, NYHA II-III, on GDMT ≥3 months?
│ └─ YES: ICD for primary prevention
│ (if life expectancy >1 year with good functional status)
│
└─ EF ≤35%, NYHA IV despite GDMT, or advanced HF?
└─ Refer to advanced HF specialist
├─ LVAD evaluation
├─ Heart transplant evaluation
└─ Palliative care consultation
Step 5: Monitoring and Titration
Weekly to biweekly visits during titration:
- Blood pressure (target SBP ≥90 mmHg)
- Heart rate (target 50-60 bpm)
- Potassium (target 4.0-5.0 mEq/L, hold MRA if >5.5)
- Creatinine (expect 10-20% increase, acceptable if <30% and stable)
- Symptoms and congestion status (daily weights, NYHA class)
Stable on GDMT:
- Visits every 3-6 months
- Echocardiogram at 3-6 months after GDMT optimization, then annually
- NT-proBNP or BNP trending (biomarker-guided therapy investigational)Risk Stratification Tools
Cardiovascular Risk Scores
TIMI Risk Score (NSTEMI/Unstable Angina)
Score Calculation (0-7 points):
☐ Age ≥65 years (1 point)
☐ ≥3 cardiac risk factors (HTN, hyperlipidemia, diabetes, smoking, family history) (1)
☐ Known CAD (stenosis ≥50%) (1)
☐ ASA use in past 7 days (1)
☐ Severe angina (≥2 episodes in 24 hours) (1)
☐ ST deviation ≥0.5 mm (1)
☐ Elevated cardiac biomarkers (1)
Risk Stratification:
├─ Score 0-1: 5% risk of death/MI/urgent revasc at 14 days (Low)
│ └─ Management: Observation, stress test, outpatient follow-up
│
├─ Score 2: 8% risk (Low-intermediate)
│ └─ Management: Admission, medical therapy, stress imaging
│
├─ Score 3-4: 13-20% risk (Intermediate-high)
│ └─ Management: Admission, aggressive medical therapy, early invasive strategy
│
└─ Score 5-7: 26-41% risk (High)
└─ Management: Aggressive treatment, urgent angiography (<24 hours)CHA2DS2-VASc Score (Stroke Risk in Atrial Fibrillation)
Score Calculation:
☐ Congestive heart failure (1 point)
☐ Hypertension (1)
☐ Age ≥75 years (2)
☐ Diabetes mellitus (1)
☐ Prior stroke/TIA/thromboembolism (2)
☐ Vascular disease (MI, PAD, aortic plaque) (1)
☐ Age 65-74 years (1)
☐ Sex category (female) (1)
Maximum score: 9 points
Treatment Algorithm:
├─ Score 0 (male) or 1 (female): 0-1.3% annual stroke risk
│ └─ No anticoagulation or aspirin (Class IIb)
│
├─ Score 1 (male): 1.3% annual stroke risk
│ └─ Consider anticoagulation (Class IIa)
│ Factors: Patient preference, bleeding risk, comorbidities
│
└─ Score ≥2 (male) or ≥3 (female): ≥2.2% annual stroke risk
└─ Anticoagulation recommended (Class I)
├─ Preferred: DOAC (apixaban, rivaroxaban, edoxaban, dabigatran)
└─ Alternative: Warfarin (INR 2-3) if DOAC contraindicated
Bleeding Risk Assessment (HAS-BLED):
H - Hypertension (SBP >160)
A - Abnormal renal/liver function (1 point each)
S - Stroke history
B - Bleeding history or predisposition
L - Labile INR (if on warfarin)
E - Elderly (age >65)
D - Drugs (antiplatelet, NSAIDs) or alcohol (1 point each)
HAS-BLED ≥3: High bleeding risk → Modifiable factors, consider DOAC over warfarinOncology Risk Calculators
MELD Score (Hepatocellular Carcinoma Eligibility)
MELD = 3.78×ln(bilirubin mg/dL) + 11.2×ln(INR) + 9.57×ln(creatinine mg/dL) + 6.43
Interpretation:
├─ MELD <10: 1.9% 3-month mortality (Low)
│ └─ Consider resection or ablation for HCC
│
├─ MELD 10-19: 6-20% 3-month mortality (Moderate)
│ └─ Transplant evaluation if within Milan criteria
│ Milan: Single ≤5cm or ≤3 lesions each ≤3cm, no vascular invasion
│
├─ MELD 20-29: 20-45% 3-month mortality (High)
│ └─ Urgent transplant evaluation, bridge therapy (TACE, ablation)
│
└─ MELD ≥30: 50-70% 3-month mortality (Very high)
└─ Transplant vs palliative care discussion
Too ill for transplant if MELD >35-40 typicallyAdjuvant! Online (Breast Cancer Recurrence Risk)
Input Variables:
- Age at diagnosis
- Tumor size
- Tumor grade (1-3)
- ER status
- Node status (0, 1-3, 4-9, ≥10)
- HER2 status
- Comorbidity index
Output: 10-year risk of:
- Recurrence
- Breast cancer mortality
- Overall mortality
Treatment Benefit Estimates:
- Chemotherapy: Absolute reduction in recurrence
- Endocrine therapy: Absolute reduction in recurrence
- Trastuzumab: Absolute reduction (if HER2+)
Clinical Application:
├─ Low risk (<10% recurrence): Consider endocrine therapy alone if ER+
├─ Intermediate risk (10-20%): Chemotherapy discussion, genomic assay
│ └─ Oncotype DX score <26: Endocrine therapy alone
│ └─ Oncotype DX score ≥26: Chemotherapy + endocrine therapy
└─ High risk (>20%): Chemotherapy + endocrine therapy if ER+TikZ Flowchart Best Practices
Visual Design Principles
Node Styling
% Decision nodes (diamond)
\tikzstyle{decision} = [diamond, draw, fill=yellow!20, text width=4.5em, text centered, inner sep=0pt]
% Process nodes (rectangle)
\tikzstyle{process} = [rectangle, draw, fill=blue!20, text width=5em, text centered, rounded corners, minimum height=3em]
% Terminal nodes (rounded rectangle)
\tikzstyle{terminal} = [rectangle, draw, fill=green!20, text width=5em, text centered, rounded corners=1em, minimum height=3em]
% Input/Output (parallelogram)
\tikzstyle{io} = [trapezium, draw, fill=purple!20, text width=5em, text centered, minimum height=3em]Color Coding by Urgency
- Red: Life-threatening, immediate action required
- Orange: Urgent, action within hours
- Yellow: Semi-urgent, action within 24-48 hours
- Green: Routine, stable clinical situation
- Blue: Informational, monitoring only
Pathway Emphasis
- Bold arrows for most common pathway
- Dashed arrows for rare scenarios
- Arrow thickness proportional to pathway frequency
- Highlight boxes around critical decision points
LaTeX TikZ Template
\documentclass{article}
\usepackage{tikz}
\usetikzlibrary{shapes, arrows, positioning}
\begin{document}
\tikzstyle{decision} = [diamond, draw, fill=yellow!20, text width=4em, text centered, inner sep=2pt, font=\small]
\tikzstyle{process} = [rectangle, draw, fill=blue!20, text width=6em, text centered, rounded corners, minimum height=2.5em, font=\small]
\tikzstyle{terminal} = [rectangle, draw, fill=green!20, text width=6em, text centered, rounded corners=8pt, minimum height=2.5em, font=\small]
\tikzstyle{alert} = [rectangle, draw=red, line width=1.5pt, fill=red!10, text width=6em, text centered, rounded corners, minimum height=2.5em, font=\small\bfseries]
\tikzstyle{arrow} = [thick,->,>=stealth]
\begin{tikzpicture}[node distance=2cm, auto]
% Nodes
\node [terminal] (start) {Patient presents with symptom X};
\node [decision, below of=start] (decision1) {Criterion A met?};
\node [alert, below of=decision1, node distance=2.5cm] (alert1) {Immediate action};
\node [process, right of=decision1, node distance=4cm] (process1) {Standard evaluation};
\node [terminal, below of=process1, node distance=2.5cm] (end) {Outcome};
% Arrows
\draw [arrow] (start) -- (decision1);
\draw [arrow] (decision1) -- node {Yes} (alert1);
\draw [arrow] (decision1) -- node {No} (process1);
\draw [arrow] (process1) -- (end);
\draw [arrow] (alert1) -| (end);
\end{tikzpicture}
\end{document}Algorithm Validation
Development Process
Step 1: Literature Review and Evidence Synthesis
- Systematic review of guidelines (NCCN, ASCO, ESMO, AHA/ACC)
- Meta-analyses of clinical trials
- Expert consensus statements
- Local practice patterns and resource availability
Step 2: Draft Algorithm Development
- Multidisciplinary team input (physicians, nurses, pharmacists)
- Define decision nodes and criteria
- Specify actions and outcomes
- Identify areas of uncertainty
Step 3: Pilot Testing
- Retrospective application to historical cases (n=20-50)
- Identify scenarios not covered by algorithm
- Refine decision criteria
- Usability testing with end-users
Step 4: Prospective Validation
- Implement in clinical practice with data collection
- Track adherence rate (target >80%)
- Monitor outcomes vs historical controls
- User satisfaction surveys
Step 5: Continuous Quality Improvement
- Quarterly review of algorithm performance
- Update based on new evidence
- Address deviations and reasons for non-adherence
- Version control and change documentation
Performance Metrics
Process Metrics
- Algorithm adherence rate (% cases following algorithm)
- Time to decision (median time from presentation to treatment start)
- Completion rate (% cases reaching terminal node)
Outcome Metrics
- Appropriateness of care (concordance with guidelines)
- Clinical outcomes (mortality, morbidity, readmissions)
- Resource utilization (length of stay, unnecessary tests)
- Safety (adverse events, errors)
User Experience Metrics
- Ease of use (Likert scale survey)
- Time to use (median time to navigate algorithm)
- Perceived utility (% users reporting algorithm helpful)
- Barriers to use (qualitative feedback)
Implementation Strategies
Integration into Clinical Workflow
Electronic Health Record Integration
- Clinical decision support (CDS) alerts at key decision points
- Order sets linked to algorithm pathways
- Auto-population of risk scores from EHR data
- Documentation templates following algorithm structure
Point-of-Care Tools
- Pocket cards for quick reference
- Mobile apps with interactive algorithms
- Wall posters in clinical areas
- QR codes linking to full algorithm
Education and Training
- Didactic presentation of algorithm rationale
- Case-based exercises
- Simulation scenarios
- Audit and feedback on adherence
Overcoming Barriers
Common Barriers
- Algorithm complexity (too many decision points)
- Lack of awareness (not disseminated effectively)
- Disagreement with recommendations (perceived as cookbook medicine)
- Competing priorities (time pressure, multiple patients)
- Resource limitations (recommended tests/treatments not available)
Mitigation Strategies
- Simplify algorithms (≤7 decision points per pathway preferred)
- Champion network (local opinion leaders promoting algorithm)
- Customize to local context (allow flexibility for clinical judgment)
- Measure and report outcomes (demonstrate value)
- Provide resources (ensure algorithm-recommended options available)
Algorithm Maintenance and Updates
Version Control
Change Log Documentation
Algorithm: NSCLC First-Line Treatment
Version: 3.2
Effective Date: January 1, 2024
Previous Version: 3.1 (effective July 1, 2023)
Changes in Version 3.2:
1. Added KRAS G12C-mutated pathway (sotorasib, adagrasib)
- Evidence: FDA approval May 2021/2022
- Guideline: NCCN v4.2023
2. Updated PD-L1 ≥50% recommendation to include pembrolizumab monotherapy as Option 1
- Evidence: KEYNOTE-024 5-year follow-up
- Guideline: NCCN Category 1 preferred
3. Removed crizotinib as preferred ALK inhibitor, moved to alternative
- Evidence: ALEX, CROWN trials showing superiority of alectinib, lorlatinib
- Guideline: NCCN/ESMO Category 1 for alectinib as first-line
Reviewed by: Thoracic Oncology Committee
Approved by: Dr. [Name], Medical Director
Next Review Date: July 1, 2024Trigger for Updates
Mandatory Updates (Within 3 Months)
- FDA approval of new drug for algorithm indication
- Guideline change (NCCN, ASCO, ESMO Category 1 recommendation)
- Safety alert or black box warning added to recommended agent
- Major clinical trial results changing standard of care
Routine Updates (Annually)
- Minor evidence updates
- Optimization based on local performance data
- Formatting or usability improvements
- Addition of new clinical scenarios encountered
Emergency Updates (Within 1 Week)
- Drug shortage requiring alternative pathways
- Drug recall or safety withdrawal
- Outbreak or pandemic requiring modified protocols
Related skills
How it compares
Pick this over generic report-generation skills when you need genomic variant sections with tiered clinical evidence formatting in LaTeX.
FAQ
What evidence tiers does clinical-decision-support use?
clinical-decision-support structures reports with three evidence tiers, each with distinct color coding in tcolorbox callouts. Tier 1, tier 2, and tier 3 grades help clinicians prioritize variant actionability at a glance.
What variant types does the clinical report include?
clinical-decision-support templates include dedicated sections for mutations, amplifications, and fusions. Variant data renders in tabularx and booktabs tables within a 10pt letterpaper LaTeX article layout.
Is Clinical Decision Support safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.