SMART: structured, meaningful, auditable, responsible, and transparent documentation for clinical AI
Open Access
- 19 August 2026
- journal article
- Published by Oxford University Press (OUP) in Journal of the American Medical Informatics Association
- Vol. 33 (10) , 1921-1933
Abstract
Objective: Clinical AI systems and models increasingly need traceable documentation that makes intended use, performance evidence, transparency, and lifecycle status explicit, yet existing model cards, datasheets, reporting guidelines, and other documentation approaches do not consistently bring together structured clinical fields, vocabulary-linked cohort descriptions, structured performance reporting, and governed documentation history. We introduce Structured, Meaningful, Auditable, Responsible, and Transparent (SMART), a framework that adapts the model card concept into structured, lifecycle-aware documentation with OMOP integration, role-based lifecycle governance, and a blockchain-backed audit trail for verifying documentation integrity and lifecycle history. Materials and Methods: Following a design-science-informed approach, we analyzed documentation requirements, reviewed existing approaches, implemented SMART through open-source packages and smart contracts, and evaluated it using example SMART model cards, an illustrative COPD exacerbation risk-prediction documentation case study, and blockchain-governed lifecycle experiments. Results: The design process resulted in the SMART framework in which documentation provisions are reflected across Schema, Lifecycle, and Chain (ie, Blockchain) components. Evaluation showed that, in multi-party settings, documentation history remains independently verifiable because lifecycle actions are role-attributed and linked to content hashes; median testnet gas use ranged from 352 722 to 852 399 gas across the evaluated lifecycle operations. Discussion: SMART positions clinical AI documentation as a shared infrastructure for preliminary model assessment, making role attribution, lifecycle state, and documentation changes more transparent and traceable over time. Conclusion: By providing an implementable framework, SMART illustrates how clinical AI documentation can be structured, clinically contextualized, auditable, responsible, transparent, and lifecycle-aware.Keywords
Funding Information
- European Union's Horizon Europe research and innovation programme (101095435)
- European Commission
- European Health and Digital Executive Agency
This publication has 14 references indexed in Scilit:
- Adoption of artificial intelligence in healthcare: survey of health system priorities, successes, and challengesJournal of the American Medical Informatics Association, 2025
- Could transparent model cards with layered accessible information drive trust and safety in health AI?npj Digital Medicine, 2025
- TRIPOD+AI statement: updated guidance for reporting clinical prediction models that use regression or machine learning methodsBMJ, 2024
- AI in health and medicineNature Medicine, 2022
- Underdiagnosis bias of artificial intelligence algorithms applied to chest radiographs in under-served patient populationsNature Medicine, 2021
- Datasheets for datasetsCommunications of the ACM, 2021
- External Validation of a Widely Implemented Proprietary Sepsis Prediction Model in Hospitalized PatientsJAMA Internal Medicine, 2021
- Dissecting racial bias in an algorithm used to manage the health of populationsScience, 2019
- High-performance medicine: the convergence of human and artificial intelligenceNature Medicine, 2019
- Mood and Modality2001