{ "model": { "rank": 5985, "code": "thing-q7069348", "model_id": "vr.tr.gallstone-disease", "name": "gallstone disease", "purpose": "Let an agent explain gallstone disease and its forms in neutral terms, relay risk factors, symptoms, diagnosis and treatment options in general from surgical and gastroenterology guidelines, and route people with symptoms to clinicians and emergencies to urgent care.", "family": "Thing Registry", "category": "Cross-cutting context", "status": "research-draft", "kind": "thing", "plane": "XCT", "domain": "XCT.STA", "industry": "", "version": "", "url": "/models/thing/q7069348/", "tier": 2, "score": 63, "payload": { "layer": "wikidata", "aliases": [ "calculus of gallbladder and bile duct with cholecystitis", "gallstone ileus", "biliary microlithiasis", "cholecystolithiasis", "biliary colic", "hepatolithiasis" ], "aliasCount": 6, "merged": 6, "knownIn": 63, "facets": null, "markers": [], "lexicalClass": "", "senseRank": null, "alsoRegisteredAs": null, "source": { "dataset": "wikidata", "item": "Q7069348", "url": "https://www.wikidata.org/wiki/Q7069348", "license": "CC0 1.0" } }, "research": { "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-13T05:09:41Z", "providers": [ "Claude" ], "breadth": "written by Claude from model knowledge without web access - no source was read, every claim is a lead to verify", "pass": 2, "wave": 3, "engine": "claude" }, "metaModel": { "id": "THING-Q7069348", "registryId": "vr.tr.gallstone-disease", "name": "gallstone disease", "version": "0.2.0-wave.3", "entryKind": "thing", "family": "Thing Registry", "domain": [ "XCT.STA" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q7069348/", "model": { "registry_id": "vr.tr.gallstone-disease", "name": "gallstone disease", "purpose": "Let an agent explain gallstone disease and its forms in neutral terms, relay risk factors, symptoms, diagnosis and treatment options in general from surgical and gastroenterology guidelines, and route people with symptoms to clinicians and emergencies to urgent care.", "definition": "A group of conditions caused by gallstones, hardened deposits of cholesterol or bilirubin forming in the gallbladder, called cholecystolithiasis, or in the bile ducts and liver, called choledocholithiasis and hepatolithiasis, and including biliary microlithiasis or sludge; gallstones may be silent or cause biliary colic, acute cholecystitis, cholangitis, pancreatitis and rarely gallstone ileus, and are treated by observation, cholecystectomy or endoscopic stone removal depending on symptoms and complications.", "what_it_is_for": "Not applicable; a disease group.", "affordances": [ "explain forms and causes", "relay diagnosis and treatment in general", "describe complications", "route to clinicians" ], "distinguishing_features": [ "Stone formation in bile", "Often silent", "Biliary colic", "Surgical treatment" ], "appearance": "Not a visible object; stones seen on ultrasound.", "visual_identification": [ "Conditions caused by gallstones", "Cholecystolithiasis, choledocholithiasis, hepatolithiasis, microlithiasis, biliary colic, cholecystitis, gallstone ileus", "Kidney stones are in the urinary tract; gallbladder polyps are not stones" ], "physical_properties": [ { "quantity": "prevalence", "typical_range": "about 10-15", "unit": "percent", "note": "adults in Western countries" }, { "quantity": "symptomatic share", "typical_range": "about 20", "unit": "percent", "note": "of people with stones" }, { "quantity": "most common composition", "typical_range": "cholesterol", "unit": "type", "note": "" } ], "families_and_kinds": [ "cholecystolithiasis in the gallbladder", "choledocholithiasis in the bile duct", "hepatolithiasis in intrahepatic ducts", "biliary microlithiasis and sludge", "complications such as cholecystitis, cholangitis, pancreatitis and gallstone ileus" ], "related_models": [ { "relation": "is a kind of", "target": "gallbladder disease", "why": "in registry terms" }, { "relation": "is caused by", "target": "gallstone", "why": "formation" }, { "relation": "is treated by", "target": "cholecystectomy", "why": "when symptomatic" }, { "relation": "can cause", "target": "acute pancreatitis", "why": "when stones obstruct" } ], "identifiers": [ { "scheme": "ICD-11", "value_or_pattern": "DC11", "note": "cholelithiasis" }, { "scheme": "MeSH", "value_or_pattern": "D042882", "note": "gallstones" } ], "standards_and_regulation": [ "Guidelines from gastroenterology and surgical societies such as EASL and SAGES", "Emergency care protocols for cholangitis and pancreatitis" ], "failure_modes_and_hazards": [ "Agents giving personal medical advice", "Delayed care for cholangitis", "Confusing gallstones with kidney stones" ], "in_scope": [], "out_of_scope": [], "characteristics": [] }, "sources": [], "structure": { "bundles": [ { "id": "help", "name": "Help", "description": "Symptoms first.", "rationale": "Safety.", "layers": [ { "id": "urgent", "name": "Urgent", "description": "Urgent symptoms.", "findings": [ { "id": "urgent-finding", "name": "Urgent", "description": "Urgent.", "questions": [ { "text": "Why do severe abdominal pain with fever, jaundice or vomiting need urgent care?", "kind": "action" }, { "text": "Is the user describing these symptoms now, which needs emergency assessment?", "kind": "boundary" } ] } ] }, { "id": "colic", "name": "Colic", "description": "Biliary colic.", "findings": [ { "id": "colic-finding", "name": "Colic", "description": "Colic.", "questions": [ { "text": "What is biliary colic, and why does recurrent pain need a clinician?", "kind": "provenance" }, { "text": "Is the user asking about their own symptoms, which needs a clinician?", "kind": "boundary" } ] } ] } ] }, { "id": "understand", "name": "Understand", "description": "The disease.", "rationale": "Clinical.", "layers": [ { "id": "causes", "name": "Causes", "description": "Causes and risk.", "findings": [ { "id": "causes-finding", "name": "Causes", "description": "Causes.", "questions": [ { "text": "How do gallstones form, and what are the risk factors?", "kind": "definition" }, { "text": "Is the question about gallstones, kidney stones or another gallbladder condition?", "kind": "boundary" } ] } ] }, { "id": "forms", "name": "Forms", "description": "Forms.", "findings": [ { "id": "forms-finding", "name": "Forms", "description": "Forms.", "questions": [ { "text": "How do cholecystolithiasis, choledocholithiasis, hepatolithiasis and microlithiasis differ?", "kind": "definition" }, { "text": "Which entry fits the specific form?", "kind": "action" } ] } ] } ] }, { "id": "care", "name": "Care", "description": "Diagnosis and treatment.", "rationale": "Clinical.", "layers": [ { "id": "diagnosis", "name": "Diagnosis", "description": "Diagnosis.", "findings": [ { "id": "diagnosis-finding", "name": "Diagnosis", "description": "Diagnosis.", "questions": [ { "text": "How are gallstones diagnosed by ultrasound, blood tests, MRCP and endoscopy?", "kind": "provenance" }, { "text": "Which references are standard?", "kind": "provenance" } ] } ] }, { "id": "treatment", "name": "Treatment", "description": "Treatment.", "findings": [ { "id": "treatment-finding", "name": "Treatment", "description": "Treatment.", "questions": [ { "text": "When is cholecystectomy or endoscopic stone removal recommended, and when is observation appropriate, in general terms?", "kind": "provenance" }, { "text": "Which sources are cited?", "kind": "provenance" } ] } ] } ] }, { "id": "context", "name": "Context", "description": "Complications and prevention.", "rationale": "Context.", "layers": [ { "id": "complications", "name": "Complications", "description": "Complications.", "findings": [ { "id": "complications-finding", "name": "Complications", "description": "Complications.", "questions": [ { "text": "What are cholecystitis, cholangitis, gallstone pancreatitis and gallstone ileus, in general terms?", "kind": "provenance" }, { "text": "Which entry fits the specific complication?", "kind": "action" } ] } ] }, { "id": "prevention", "name": "Prevention", "description": "Prevention.", "findings": [ { "id": "prevention-finding", "name": "Prevention", "description": "Prevention.", "questions": [ { "text": "What lifestyle factors affect gallstone risk, as studies report?", "kind": "provenance" }, { "text": "Which entry fits gallstone prevention?", "kind": "action" } ] } ] } ] } ] }, "openQuestions": [ "Should cholecystitis and biliary colic be separate primary entries?", "How should guidelines be linked?", "The registry entry has merged aliases naming forms and complications; should they be split off?" ], "statistics": { "bundles": 4, "layers": 8, "findings": 8, "questions": 16 } }, "draft": { "generator": "vr.draft.v3", "status": "draft-generated", "researched": false, "archetype": "disease or condition", "method": "Written from the archetype playbook - what this kind of thing needs beyond identity and provenance - and from the structure that recurred across 6,333 models already researched by two engines. Applied to this entry by rule. No source was read for this thing and no claim here is researched. This entry carries no facets of its own, so they were inferred from its domain - a guess about a whole domain applied to one thing.", "facetsInferred": true, "nextPass": "A researcher replaces this draft with a sourced specification. Treat every sentence below as a proposal to argue with.", "purpose": "Give an agent a durable, checkable way to recognise a gallstone disease, record what state it is in, and decide what may be done with it.", "whatItIs": "Let an agent explain gallstone disease and its forms in neutral terms, relay risk factors, symptoms, diagnosis and treatment options in general from surgical and gastroenterology guidelines, and route people with symptoms to clinicians and emergencies to urgent care.", "characteristics": { "substance": "abstract", "origin": "conceptual", "agency": "inert" }, "whatYouCanDoWithIt": [ "observed and measured" ], "distinguishingFeatures": [ "Names folded into this entry, which a task may need to split apart again: calculus of gallbladder and bile duct with cholecystitis, gallstone ileus, biliary microlithiasis, cholecystolithiasis, biliary colic, hepatolithiasis.", "6 finer distinctions are held as aliases rather than separate entries, because telling them apart needs a task that asks for it.", "Described in 63 Wikipedia languages, which is a measure of how widely the thing is known, not of how important it is." ], "openQuestionsForResearch": [ "Which of the bundles below does a real task actually need, and which are ceremony?", "What does this thing have that the facets do not capture at all?", "Which neighbouring kind is most often confused with a gallstone disease, and on what evidence are they told apart?" ], "whatItIsMadeOf": "an abstraction with no physical instance", "physicalCharacter": [ "Does nothing on its own; everything it does, something else did to it.", "These come from the domain this entry sits in rather than from the entry itself, so treat them as a first guess about the whole domain applied to one thing." ], "whatCanBeDoneWithIt": [ "observe it, measure it, record its state" ], "howItIsRecognised": [ "Recognised by criteria applied to signs and findings, not by appearance. Two conditions can look identical and be distinguished only by test." ], "relatedModels": [ { "relation": "covers", "note": "Finer kinds folded into this entry because telling them apart needs a task that asks for it. Each is a model waiting to be split out when one does.", "targets": [ "calculus of gallbladder and bile duct with cholecystitis", "gallstone ileus", "biliary microlithiasis", "cholecystolithiasis", "biliary colic", "hepatolithiasis" ] } ], "standing": "Described in 63 Wikipedia languages, which measures how widely it is written about rather than how important or how common it is. 6 finer distinctions are held inside this entry as names rather than as separate models.", "structure": { "bundles": [ { "id": "identity-and-classification", "name": "Identity, naming and classification", "description": "How an agent tells one gallstone disease from another, and a gallstone disease from things that resemble it.", "rationale": "Recognition comes before every other claim. Without stable identity nothing else in the model can be trusted to be about the same thing twice.", "layers": [ { "id": "naming-and-identifiers", "name": "Names and identifiers", "description": "The names this thing goes by and the identifiers that survive translation and time.", "findings": [ { "id": "preferred-name-and-aliases", "name": "Preferred name, aliases and local names", "description": "Which name to use, which names mean the same thing, and which merely sound similar.", "questions": [ { "id": "preferred-name-and-aliases-q01", "text": "What identifies and describes the name of a gallstone disease, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "preferred-name-and-aliases-q02", "text": "Who or what asserted this about the name of a gallstone disease, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "preferred-name-and-aliases-q03", "text": "What may an agent decide or do once the name of a gallstone disease is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] }, { "id": "stable-identifiers", "name": "Stable identifiers and external keys", "description": "Identifiers that keep pointing at this kind of thing across systems and languages.", "questions": [ { "id": "stable-identifiers-q01", "text": "What identifies and describes an identifier for a gallstone disease, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "stable-identifiers-q02", "text": "Who or what asserted this about an identifier for a gallstone disease, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "stable-identifiers-q03", "text": "What may an agent decide or do once an identifier for a gallstone disease is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "classification-and-granularity", "name": "Classification and granularity", "description": "Where a gallstone disease sits among kinds, and how finely a task needs to cut it.", "findings": [ { "id": "kind-and-parents", "name": "Kind, parents and neighbouring kinds", "description": "The classes this thing belongs to and the ones it is next to.", "questions": [ { "id": "kind-and-parents-q01", "text": "What identifies and describes the kind of a gallstone disease, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "kind-and-parents-q02", "text": "Who or what asserted this about the kind of a gallstone disease, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "kind-and-parents-q03", "text": "What may an agent decide or do once the kind of a gallstone disease is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] }, { "id": "distinguishing-features", "name": "Distinguishing features", "description": "What separates a gallstone disease from the things most often confused with it.", "questions": [ { "id": "distinguishing-features-q01", "text": "What identifies and describes what distinguishes a gallstone disease, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "distinguishing-features-q02", "text": "Who or what asserted this about what distinguishes a gallstone disease, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "distinguishing-features-q03", "text": "What may an agent decide or do once what distinguishes a gallstone disease is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "state-and-lifecycle", "name": "State and lifecycle", "description": "The states a gallstone disease passes through and the events that move it between them.", "rationale": "Most decisions about a thing depend on what state it is in now, which is a claim with a time on it, not a property.", "layers": [ { "id": "lifecycle-stages", "name": "Lifecycle stages", "description": "From coming into existence to ceasing to be one of these.", "findings": [ { "id": "stages-and-transitions", "name": "Stages and transitions", "description": "The stages worth naming and what moves a gallstone disease between them.", "questions": [ { "id": "stages-and-transitions-q01", "text": "What identifies and describes the lifecycle of a gallstone disease, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "stages-and-transitions-q02", "text": "Who or what asserted this about the lifecycle of a gallstone disease, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "stages-and-transitions-q03", "text": "What may an agent decide or do once the lifecycle of a gallstone disease is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "observations-and-status", "name": "Observations and current status", "description": "What is observed about a gallstone disease, how often and by whom.", "findings": [ { "id": "observation-record", "name": "Observation record", "description": "How an observation of a gallstone disease is recorded so that it can be superseded rather than overwritten.", "questions": [ { "id": "observation-record-q01", "text": "What identifies and describes an observation of a gallstone disease, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "observation-record-q02", "text": "Who or what asserted this about an observation of a gallstone disease, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "observation-record-q03", "text": "What may an agent decide or do once an observation of a gallstone disease is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "diagnosis-and-criteria", "name": "Diagnosis, criteria and coding", "description": "What makes a case of gallstone disease a case, and under which revision.", "rationale": "Criteria change between revisions, so a diagnosis without its coding revision cannot be compared with a later one.", "layers": [ { "id": "criteria", "name": "Diagnostic criteria", "description": "The criteria in force and who issues them.", "findings": [ { "id": "criteria-record", "name": "Criteria, issuer and revision", "description": "What must be true for a diagnosis, according to whom.", "questions": [ { "id": "criteria-record-q01", "text": "What criteria define gallstone disease, issued by which body, in which revision?", "kind": "definition" }, { "id": "criteria-record-q02", "text": "What changed between revisions that would reclassify existing cases?", "kind": "boundary" } ] } ] }, { "id": "coding", "name": "Coding and terminology", "description": "The codes used to record it and their mapping.", "findings": [ { "id": "coding-record", "name": "Codes and mappings", "description": "Which classification codes apply and how they map.", "questions": [ { "id": "coding-record-q01", "text": "Which classification and terminology codes cover gallstone disease, and how do they map to each other?", "kind": "definition" }, { "id": "coding-record-q02", "text": "What is lost when a case is mapped from one scheme to another?", "kind": "boundary" } ] } ] } ] }, { "id": "course-and-population", "name": "Course, population and care", "description": "How gallstone disease develops, whom it affects, and what is done about it.", "rationale": "The condition, the diagnosis and the episode of care are three different things, and an agent must not merge them.", "layers": [ { "id": "course", "name": "Course and stages", "description": "Onset, progression, remission and outcome.", "findings": [ { "id": "course-record", "name": "Stages and transitions", "description": "The stages recorded and what moves a case between them.", "questions": [ { "id": "course-record-q01", "text": "What course does gallstone disease typically take, and what marks each stage?", "kind": "definition" }, { "id": "course-record-q02", "text": "What separates the condition itself from an episode of care for it?", "kind": "boundary" } ] } ] }, { "id": "population", "name": "Affected populations", "description": "Who is affected, how often, and on what evidence.", "findings": [ { "id": "epidemiology", "name": "Prevalence and its basis", "description": "Rates with their population, period and source.", "questions": [ { "id": "epidemiology-q01", "text": "What prevalence or incidence is reported for gallstone disease, in which population and period?", "kind": "measurement" }, { "id": "epidemiology-q02", "text": "What may an agent not conclude about an individual from a population rate?", "kind": "action" } ] } ] } ] }, { "id": "provenance-and-evidence", "name": "Provenance, evidence and time", "description": "Where every claim about a gallstone disease came from and when it held.", "rationale": "A claim without a source and a time cannot be superseded, only overwritten, and an agent that overwrites loses the ability to explain itself.", "layers": [ { "id": "source-and-authority", "name": "Source and authority", "description": "Who said it, on what evidence, and how strongly.", "findings": [ { "id": "claim-provenance", "name": "Claim provenance and confidence", "description": "The authority behind each claim about a gallstone disease and how confident it is.", "questions": [ { "id": "claim-provenance-q01", "text": "What identifies and describes a claim about a gallstone disease, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "claim-provenance-q02", "text": "Who or what asserted this about a claim about a gallstone disease, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "claim-provenance-q03", "text": "What may an agent decide or do once a claim about a gallstone disease is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "time-and-versions", "name": "Time, versions and supersession", "description": "When a claim was true, when it was learnt, and what replaced it.", "findings": [ { "id": "validity-and-supersession", "name": "Validity period and supersession", "description": "How an old claim about a gallstone disease is retired without being erased.", "questions": [ { "id": "validity-and-supersession-q01", "text": "What identifies and describes the validity of a claim about a gallstone disease, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "validity-and-supersession-q02", "text": "Who or what asserted this about the validity of a claim about a gallstone disease, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "validity-and-supersession-q03", "text": "What may an agent decide or do once the validity of a claim about a gallstone disease is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] } ] }, "statistics": { "bundles": 5, "layers": 10, "findings": 12, "questions": 32 } } } }