SMART Base
0.2.0 - ci-build
SMART Base, published by WHO. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-base/tree/main and changes regularly. See the Directory of published versions
Built from commit d97caff5.
Each authoring skill is modeled as a FHIR Requirements resource conforming to the SGRequirements profile. Each skill states a capability (e.g. "Can review terminology") and contains checklist statements that define the criteria for demonstrating that capability.
Skills are organized by domain and assigned to authoring personas to define each persona's skill package.
| Skill | Description | Personas | |——-|————-|———-| | Can review and approve content | Review and formally approve content at decision gates | Content Reviewer |
| Skill | Description | Personas | |——-|————-|———-| | Can scope DAK | Define DAK scope, source documents, and development process | Programme Manager | | Can manage stakeholders | Engage SMEs, coordinate consultations, manage RASCI | Programme Manager, Technical Officer | | Can plan iterations | Plan sprints, maintain backlog, facilitate retrospectives | Programme Manager |
| Skill | Description | Personas | |——-|————-|———-| | Can review L1 guidelines | Review WHO L1 guidelines for accuracy and completeness | Technical Officer, Clinical SME, Business Analyst, QC Reviewer | | Can interpret clinical recommendations | Interpret clinical recommendations with domain expertise | Clinical SME, Technical Officer |
| Skill | Description | Personas | |——-|————-|———-| | Can author personas | Define generic personas from guidelines and ground-truthing | Business Analyst, Clinical SME | | Can author user scenarios | Create user scenario narratives | Business Analyst | | Can author business processes | Create BPMN 2.0 business process diagrams | Business Analyst | | Can author data dictionary | Define core data elements with terminology mappings | Business Analyst | | Can author decision-support logic | Develop DMN decision-support logic tables | Business Analyst | | Can author scheduling logic | Develop DMN scheduling logic tables | Business Analyst | | Can author indicators | Define indicators with numerator/denominator | Business Analyst | | Can author functional requirements | Define functional and non-functional requirements | Business Analyst | | Can validate DAK content | Review DAK for L1 accuracy and cross-component consistency | Technical Officer, Clinical SME, Business Analyst, QC Reviewer |
| Skill | Description | Personas | |——-|————-|———-| | Can author logical models | Create FHIR logical models from L2 data dictionaries | FHIR Modeller | | Can author FHIR profiles | Create FHIR profiles constraining base resources | FHIR Modeller | | Can author questionnaires | Create FHIR Questionnaire resources | FHIR Modeller | | Can author CQL | Write CQL for decision logic, scheduling, and indicators | FHIR Modeller | | Can author structure maps | Create FHIR StructureMaps for data extraction | FHIR Modeller | | Can author plan definitions | Create PlanDefinitions for processes and decision tables | FHIR Modeller | | Can author actor definitions | Create ActorDefinitions, reusing Commons repository | FHIR Modeller | | Can author example scenarios | Create ExampleScenario resources | FHIR Modeller | | Can author measures | Create FHIR Measure resources from L2 indicators | FHIR Modeller | | Can author FHIR requirements | Create FHIR Requirements resources | FHIR Modeller | | Can author test cases | Create TestPlan, TestScript, and example instances | FHIR Modeller |
| Skill | Description | Personas | |——-|————-|———-| | Can review terminology | Review terminology bindings, code systems, and value sets | Terminologist, QC Reviewer | | Can map concepts | Map to WHO Commons, ICD-11, SNOMED CT, LOINC | Terminologist | | Can author code systems | Create and maintain FHIR CodeSystem resources | Terminologist, FHIR Modeller | | Can author value sets | Create and maintain FHIR ValueSet resources | Terminologist, FHIR Modeller | | Can author concept maps | Create FHIR ConceptMap resources | Terminologist, FHIR Modeller |
| Skill | Description | Personas | |——-|————-|———-| | Can run QA checks | Run and interpret IG Publisher QA reports | QC Reviewer, FHIR Modeller, Publication Manager, Terminologist | | Can review checklist | Review publication checklist across L1-L4 | QC Reviewer, Publication Manager | | Can validate artifact conformance | Verify CRMI profile conformance | QC Reviewer | | Can validate L3 functionality | Test StructureMaps, CQL, and Measures | QC Reviewer |
| Skill | Description | Personas | |——-|————-|———-| | Can configure IG | Set up IG repository and sushi-config | Publication Manager, FHIR Modeller | | Can build IG | Run IG Publisher build process | Publication Manager, FHIR Modeller | | Can manage releases | Manage versioning, tags, and publication workflow | Publication Manager | | Can manage governance | Manage cross-IG shared artifacts and governance | Publication Manager, Terminologist |
| Skill | Description | Personas | |——-|————-|———-| | Can translate content | Translate IG content across UN languages | Translator | | Can review translations | Review translated content for accuracy | Translator, QC Reviewer |
Each persona has a defined package of skills. The full set of skills for each persona is available on the persona's Requirements resource page:
| Persona | Skill Count | Key Domains |
|---|---|---|
| Programme Manager | 3 | Project Management |
| Technical Officer | 4 | L1 Review, Stakeholder Management, DAK Validation |
| Clinical SME | 4 | L1 Review, Clinical Interpretation, DAK Validation |
| Business Analyst | 11 | L2 DAK Authoring (all 9 components), L1 Review |
| FHIR Modeller | 17 | L3 FHIR Authoring, Terminology, QA, IG Build |
| Terminologist | 7 | Terminology Management, Governance |
| QC Reviewer | 7 | QA, Checklists, Conformance, Functionality Testing |
| Content Reviewer | 1 | Content Approval at decision gates |
| Publication Manager | 6 | IG Configuration, Build, Release, Governance |
| Translator | 2 | Translation, Review |
As part of the BPMN authoring and review process, every innermost swimlane in a BPMN diagram SHALL correspond to an ActorDefinition resource. The bpmn_layout skill includes a validate-swimlanes command that checks this automatically.
When a swimlane has no matching ActorDefinition, the author must resolve by: