Maintenance Notice

Due to necessary scheduled maintenance, the JMIR Publications website will be unavailable from Wednesday, July 01, 2020 at 8:00 PM to 10:00 PM EST. We apologize in advance for any inconvenience this may cause you.

Who will be affected?

Accepted for/Published in: Journal of Medical Internet Research

Date Submitted: May 13, 2026
Date Accepted: Oct 28, 2026

The final, peer-reviewed published version of this preprint can be found here:

Beyond Model Choice: A Harness-Centered Framework for Designing Clinical Large Language Model Agents

Liu J, Liu S

Beyond Model Choice: A Harness-Centered Framework for Designing Clinical Large Language Model Agents

J Med Internet Res 2026;28:e101269

DOI: 10.2196/101269

Beyond Model Choice: A Harness-Centered Framework for Designing Clinical Large Language Model Agents

  • Jialin Liu; 
  • Siru Liu

ABSTRACT

Large language model (LLM) agents are increasingly deployed in clinical settings to execute multistep tasks such as electronic health record retrieval, clinical decision support, and patient communication. Discussion of these systems has focused largely on which foundation model performs best on medical benchmarks. This focus understates the role of the harness, the engineered scaffolding around the model that defines system prompts, tool interfaces, control flow, output schemas, memory, and verification logic. Recent benchmarks demonstrate that for medical agent tasks, harness design can change task success rates by tens of percentage points while the underlying model is held constant, and that the choice of agent architecture often outweighs the choice of base model. Although recent work has surveyed medical agent architectures at the system level, proposed agent engineering frameworks for biomedical research, and articulated governance competencies for clinicians supervising agents, the harness layer between these levels has received limited systematic attention. We propose a three-tier harness-centered framework: tier 1 specifies foundational harness components shared with general-domain agents (system prompts, tool definitions, output schemas, control flow, memory); tier 2 introduces medical-specific harness components addressing clinical knowledge integration, differential reasoning structure, missing-data handling, safety verification, and clinical workflow alignment; tier 3 establishes failure-mode-driven adaptation through systematic trace analysis, taxonomy-guided redesign, and cross-benchmark validation. We illustrate each tier with evidence from recent medical agent benchmarks, discuss operationalization for development teams, address an alternative view that frames harness engineering as a temporary patch superseded by future fine-tuning, and identify open questions for the field.


 Citation

Please cite as:

Liu J, Liu S

Beyond Model Choice: A Harness-Centered Framework for Designing Clinical Large Language Model Agents

J Med Internet Res 2026;28:e101269

DOI: 10.2196/101269

Download PDF


Request queued. Please wait while the file is being generated. It may take some time.

© The authors. All rights reserved. This is a privileged document currently under peer-review/community review (or an accepted/rejected manuscript). Authors have provided JMIR Publications with an exclusive license to publish this preprint on it's website for review and ahead-of-print citation purposes only. While the final peer-reviewed paper may be licensed under a cc-by license on publication, at this stage authors and publisher expressively prohibit redistribution of this draft paper other than for review purposes.