WHO SMART Guidelines content types

On this page
  1. WHO SMART Guidelines DAKs (L2)
  2. WHO SMART Implementation Guides (L3)

This page is generated from site-docs/source/concepts-who-smart-content-types/ — each section below links to its own source.

WHO SMART Guidelines DAKs (L2)

✎ Edit

Skill package: authoring-who-smart-guidelines · Guide: Authoring a WHO SMART DAK

A Digital Adaptation Kit (DAK) is the L2 (machine-readable, but implementation-neutral) representation of a WHO guideline. folio-assistant authors the L2 artifacts:

  • Business processes — BPMN 2.0 workflows (bpmn-authoring)
  • Decision logic — DMN decision tables (dmn-authoring)
  • Data dictionaries / core data elements — Excel / structured tables
  • Terminology — code systems and value sets (terminology-management)
  • Personas, scenarios, indicators, requirements

Relevant skill schemas: l2-dak-authoring, bpmn-authoring, dmn-authoring, terminology-management.

BPMN swimlane diagram of L2 DAK authoring: a parallel gateway fans out personas, BPMN processes, DMN decision logic, the data dictionary and indicators across the business-analyst lane alongside the terminologist's bindings, then clinical SME validation gates assembly of the DAK.

BPMN 2.0 source · full-size SVG


WHO SMART Implementation Guides (L3)

✎ Edit

Skill package: authoring-who-smart-guidelines · Guide: Authoring a WHO SMART IG

The L3 layer turns an L2 DAK into a computable FHIR Implementation Guide:

  • FHIR resources authored as FSH (FHIR Shorthand) and compiled with SUSHI (l3-fhir-authoring)
  • Validation against FHIR profiles (fhir-validation)
  • Publication with the HL7 FHIR IG Publisher (ig-publication)
  • Quality control gates (quality-control)

Relevant skill schemas: l3-fhir-authoring, fhir-validation, ig-publication, quality-control.

BPMN swimlane diagram of the L3 pipeline: map L2 to L3, author FSH, SUSHI compile, validate against profiles with a loop back to FSH on failure, QC gates that file findings as beans, IG Publisher build, and publication of the IG site.

BPMN 2.0 source · full-size SVG



folio-assistant — code under the Apache License 2.0, documentation under CC BY 3.0. Generated schema and API references are rebuilt from source on every push to main.

deployed b08c961 · 2026-10-23T23:11:09Z