This skill teaches the agent how to reason about clinical terminology systems — MedDRA, ICD-10, SNOMED CT, and LOINC — and the decisions involved in coding, grouping, and mapping clinical data. It does not generate pipeline code; it provides the domain knowledge needed to make correct coding and aggregation choices before any analysis begins.
Getting terminology wrong has direct consequences: miscoded adverse events hide safety signals, wrong ICD-10 granularity inflates or deflates prevalence estimates, and incorrect LOINC assignments break lab result interoperability. This skill encodes the rules, hierarchies, and decision frameworks that prevent those errors.
MedDRA (Medical Dictionary for Regulatory Activities) is the standard for coding adverse events, medical history, and indications in clinical trials and pharmacovigilance.
ICD-10 (International Classification of Diseases, 10th Revision) is the standard for diagnosis coding in claims, EHR, and epidemiological studies.
SNOMED CT (Systematized Nomenclature of Medicine — Clinical Terms) is the most comprehensive clinical terminology, used for clinical findings, procedures, substances, body structures, and organisms.
LOINC (Logical Observation Identifiers Names and Codes) is the standard for identifying laboratory tests and clinical observations.
Mapping between terminology systems is necessary but error-prone. Follow these rules:
-
Wrong: Coding adverse events directly to PT, skipping the LLT layer
Right: Always code verbatim text to LLT first, then let the hierarchy derive the PT
Why: The LLT layer captures synonyms and spelling variants — skipping it risks inconsistent coding when different verbatim texts describe the same concept
-
Wrong: Using secondary SOC for AE frequency tables
Right: Always use the primary SOC for frequency tables unless the protocol explicitly specifies otherwise
Why: Multi-axial PTs appear under multiple SOCs — mixing primary and secondary inflates apparent AE counts and confuses signal detection
-
Wrong: Aggregating at HLT level without documenting justification
Right: Only aggregate above PT when individual terms are too sparse for signal detection; always show both grouped and ungrouped PT counts
Why: HLT grouping hides individual PT signals that may represent distinct safety concerns
-
Wrong: Applying ICD-10-CM codes in a non-US context
Right: Specify which ICD-10 modification you are using; use ICD-10-WHO or the appropriate national modification for non-US data
Why: ICD-10-CM extensions (laterality, encounter type) do not exist in ICD-10-WHO — codes may be invalid or misinterpreted
-
Wrong: Grouping ICD-10 at 3-character level for specific outcome studies
Right: Use full codes (4+ characters) when the outcome is a specific manifestation; document inclusion/exclusion codes explicitly
Why: E11 includes all Type 2 DM complications — if the outcome is "Type 2 DM with hyperglycemia," only E11.65 is correct
-
Wrong: Reversing the SNOMED CT → ICD-10 map to create an ICD-10 → SNOMED CT crosswalk
Right: Use a dedicated reverse crosswalk or UMLS CUI-based mappings; never invert the forward map
Why: The forward map is many-to-one — reversing it creates ambiguous one-to-many mappings without the map rules to resolve them
-
Wrong: Matching LOINC codes by component name alone
Right: Verify all six LOINC axes (component, property, timing, system, scale, method) match the local test definition
Why: Two LOINC codes can share the same component but differ in system (serum vs urine), property, or scale — partial matching produces wrong assignments
-
Wrong: Using deprecated LOINC codes without checking status
Right: Always check the LOINC STATUS field and replace deprecated codes with their active successors
Why: Deprecated codes break interoperability and may not be recognized by receiving systems
-
Wrong: Creating ad hoc terminology crosswalks instead of using official maps
Right: Use curated maps from SNOMED International, NLM, or MSSO; document the map version used
Why: Ad hoc mappings introduce inconsistencies, are not reproducible, and diverge from regulatory expectations
-
Wrong: Ignoring MedDRA version differences when combining data across studies
Right: Document the MedDRA version used for each study; reconcile terms that were added, merged, or deprecated across versions
Why: PTs are added, merged, and deprecated across versions — a term valid in v25 may be deprecated in v26, causing data loss or miscounting
-
Wrong: Confusing LOINC panel codes with component codes when storing results
Right: Use the panel code for the order and individual component LOINC codes for each result within the panel
Why: Storing a glucose result under the CBC panel code is semantically wrong and breaks downstream aggregation and interoperability
-
Wrong: Mapping MedDRA directly to SNOMED CT without an intermediary
Right: Use ICD-10 as an intermediary (MedDRA → ICD-10 → SNOMED CT) or use UMLS CUI-based mappings; document the mapping path
Why: No official direct MedDRA ↔ SNOMED CT crosswalk exists — direct mapping produces unvalidated, irreproducible results