Clinical Practice Guidelines, published by HL7 International / Clinical Decision Support. This guide is not an authorized publication; it is the continuous build for version 3.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/cqf-recommendations/ and changes regularly. See the Directory of published versions
This page was reorganized and editorially revised in this version of the guide (see FHIR-59639 in the change log).
The Approach section describes how guideline developers, knowledge engineers (and other informaticists), and implementers can work together across the lifecycle of a computable Clinical Practice Guideline (CPG). That lifecycle covers more than the guideline itself. It includes the activities that follow from it, such as clinical decision support, quality measurement, case reporting, and continuous improvement, all built on existing standards.
The approach has three parts:
This section is not a step-by-step guide to particular tools. It gives each contributor enough context to understand their role and how it connects to the others. It also explains the reasoning behind the Profiles and Conformance requirements in this guide. The Methodology page applies this approach in a concrete process (Select, Represent, Translate, Validate).
The CPG development team is cross-functional, and one person may hold several of these roles. Each path lists Approach pages in reading order, followed by where to apply them. The Conceptual Knowledge Architecture Index is a reference for every role.
This section describes how guideline concepts become computable knowledge artifacts. Its core idea is to keep three concerns apart:
Keeping these concerns apart lets each be expressed at the right level of detail, without mixing logic that belongs to different concerns or adding complexity that has no value. The separation is the basis for the CPG profiles, such as CPGCase, CPGPathwayDefinition, and CPGCarePlan.
Two ideas build on this separation and recur across this guide:
Metrics evaluate where a patient stands relative to the guideline, such as compliance with a recommendation or adherence to a strategy. The same patient-level results can support care, roll up into population measures, and inform the evidence ecosystem. See Metrics.
This section describes how guidelines are developed: who takes part, and the processes, tools, and frameworks they use. It explains where a computable CPG fits in the evidence ecosystem and in a Learning Health System. It also covers the computable artifacts that express a guideline and the artifacts derived from it (for example, quality measures), along with their value to stakeholders.
This section describes the activities, techniques, and tools that knowledge engineers use to turn a guideline's narrative content into a faithful computable representation. That representation uses the conceptual knowledge architecture and the CPG profiles. The section also describes an agile approach to CPG development, in which an integrated, cross-functional team uses composite artifacts and test-driven techniques to produce high-quality artifacts quickly.
This section describes the levels of representation a guideline passes through: narrative (L1), semi-structured (L2), structured and computable (L3), and executable in a real-world system (L4). It also describes the tiers of functionality (data, logic, and user interface) found at each level. Representations at the intermediate levels are useful work products in their own right. Clinical experts and knowledge engineers use them to check each other's understanding, and they give downstream implementers guidance. The section also covers knowledge assets, their metadata, and the architecture that defines how assets relate to one another.
This section describes three ways to implement computable knowledge: as a specification that is built by hand, by automatic translation, or by native execution. It also describes how the resulting inferences can be integrated with clinical information systems, and how they can support guideline-informed workflows. The section closes with the levels of enablement and the conformance requirements for implementations of this guide.