{
  "vercy": "1.0-draft",
  "publication": {
    "status": "research-draft",
    "adjudicationStatus": "unreviewed",
    "publishableCanonical": false,
    "generatedAt": "2026-09-12T20:13:52Z",
    "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",
    "enrichment": {
      "pass": 3,
      "engine": "claude",
      "producedAt": "2026-10-06T10:00:00Z",
      "ingestedAt": "2026-10-06T07:00:47+00:00",
      "fields": [
        "agent_conduct",
        "ethics",
        "owners"
      ]
    },
    "gate": {
      "passed": true,
      "version": "1.0",
      "at": "2026-10-06T19:51:53+00:00",
      "evidence": [
        "completeness 1.00",
        "sense: Wikidata description",
        "2 live sources",
        "review by codex: pass"
      ]
    }
  },
  "metaModel": {
    "id": "THING-Q12029",
    "registryId": "vr.tr.addiction",
    "name": "addiction",
    "version": "0.2.0-wave.3",
    "entryKind": "thing",
    "family": "Thing Registry",
    "domain": [
      "ACT.ACT"
    ],
    "status": "research-draft"
  },
  "canonicalUrl": "https://ver.cy/models/thing/q12029/",
  "model": {
    "registry_id": "vr.tr.addiction",
    "name": "addiction",
    "purpose": "Let an agent explain addiction in general terms as a health condition, relay evidence-based treatment and support information from health authorities and helplines, present debates about definition and policy with attribution, and route personal or crisis situations to appropriate services first.",
    "definition": "A chronic condition in which a person compulsively uses a substance or engages in a behaviour despite harmful consequences, with loss of control, craving and often tolerance and withdrawal; recognised in medical classifications as substance use disorders and behavioural addictions such as gambling, and treated through medical, psychological and social support.",
    "what_it_is_for": "Not applicable; a health condition.",
    "affordances": [
      "explain the condition and its features",
      "relay treatment and support options from authorities",
      "relay helplines and services by region",
      "present policy and definition debates with attribution"
    ],
    "distinguishing_features": [
      "Compulsion and loss of control",
      "Continued use despite harm",
      "Substance and behavioural forms",
      "Treatable with evidence-based care"
    ],
    "appearance": "Not visible as an object; a pattern of behaviour and its consequences.",
    "visual_identification": [
      "Compulsive use despite harm",
      "Loss of control and craving",
      "Physical dependence alone and heavy use without harm are distinguished in classifications"
    ],
    "physical_properties": [
      {
        "quantity": "people with substance use disorders",
        "typical_range": "tens of millions",
        "unit": "people worldwide",
        "note": "UN and WHO estimates"
      }
    ],
    "families_and_kinds": [
      "alcohol use disorder",
      "nicotine dependence",
      "opioid and other drug use disorders",
      "behavioural addictions such as gambling and gaming",
      "caffeine dependence as a milder pattern",
      "polysubstance use"
    ],
    "related_models": [
      {
        "relation": "is a kind of",
        "target": "health problem",
        "why": "a medical condition"
      },
      {
        "relation": "is classified as",
        "target": "substance use disorder",
        "why": "in ICD and DSM"
      },
      {
        "relation": "is treated by",
        "target": "addiction medicine",
        "why": "the specialty"
      },
      {
        "relation": "is related to",
        "target": "harm reduction",
        "why": "a public health approach"
      }
    ],
    "identifiers": [
      {
        "scheme": "ICD-11",
        "value_or_pattern": "6C40-6C4Z",
        "note": "disorders due to substance use"
      },
      {
        "scheme": "DSM-5",
        "value_or_pattern": "substance use disorders",
        "note": "graded mild to severe"
      }
    ],
    "standards_and_regulation": [
      "WHO and national clinical guidelines on treatment",
      "Drug control laws, which vary by country",
      "Health data confidentiality rules",
      "Advertising and sales rules for alcohol, tobacco and gambling"
    ],
    "failure_modes_and_hazards": [
      "Overdose and death",
      "Stigma delaying help",
      "Relapse without support",
      "Agents giving personal medical advice or moralising"
    ],
    "in_scope": [],
    "out_of_scope": [],
    "characteristics": [],
    "agent_conduct": {
      "may": [
        "Explain addiction as a recognised medical condition and describe treatment and support services.",
        "Direct people to helplines and professional services when they ask for help."
      ],
      "must_not": [
        "Shame, blame or use stigmatising labels for people with addiction.",
        "Help a person obtain drugs or relapse, or promote gambling to someone who has self-excluded.",
        "Design products or messages to exploit compulsive behaviour.",
        "Disclose a person's addiction or treatment without consent."
      ],
      "requires_human": [
        "Any intervention for a person in crisis or at risk of overdose."
      ]
    },
    "ethics": {
      "considerations": [
        "Addiction is a health condition; stigma keeps people from seeking help.",
        "Industries profit from compulsive use, and design choices can deepen harm."
      ],
      "affected_parties": [
        "People with addiction",
        "Families",
        "Communities affected by drug harm"
      ]
    },
    "owners": {
      "steward": "The person concerned for their own care; health services that treat them.",
      "master_systems": []
    }
  },
  "sources": [
    {
      "id": "wikidata",
      "title": "Wikidata item Q12029: addiction",
      "url": "https://www.wikidata.org/wiki/Q12029",
      "url_status": "live",
      "what_it_supports": "identity and sense of the item",
      "checked_by": "wikidata-api"
    },
    {
      "id": "wikipedia-en",
      "title": "Wikipedia: Addiction",
      "url": "https://en.wikipedia.org/wiki/Addiction",
      "url_status": "live",
      "what_it_supports": "general description of the item",
      "checked_by": "wikidata-api sitelink"
    }
  ],
  "structure": {
    "bundles": [
      {
        "id": "understand",
        "name": "Understand",
        "description": "What addiction is.",
        "rationale": "General information.",
        "layers": [
          {
            "id": "definition",
            "name": "Definition",
            "description": "Definition and features.",
            "findings": [
              {
                "id": "definition-finding",
                "name": "Definition",
                "description": "Definition.",
                "questions": [
                  {
                    "text": "What defines addiction in current classifications, and what are its features?",
                    "kind": "definition"
                  },
                  {
                    "text": "Is the user in crisis or at risk of overdose, which must be routed to emergency services now?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          },
          {
            "id": "causes",
            "name": "Causes",
            "description": "Causes and risk.",
            "findings": [
              {
                "id": "causes-finding",
                "name": "Causes",
                "description": "Causes.",
                "questions": [
                  {
                    "text": "What do research and health bodies say about causes and risk factors, with attribution?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Is the presentation free of moralising?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "help",
        "name": "Help",
        "description": "Treatment and support.",
        "rationale": "Support first.",
        "layers": [
          {
            "id": "treatment",
            "name": "Treatment",
            "description": "Treatment.",
            "findings": [
              {
                "id": "treatment-finding",
                "name": "Treatment",
                "description": "Treatment.",
                "questions": [
                  {
                    "text": "What evidence-based treatments do guidelines describe, in general terms?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Is the presentation free of personal treatment advice?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          },
          {
            "id": "services",
            "name": "Services",
            "description": "Helplines and services.",
            "findings": [
              {
                "id": "services-finding",
                "name": "Services",
                "description": "Services.",
                "questions": [
                  {
                    "text": "Which helplines and services exist in the region, and how are they reached?",
                    "kind": "action"
                  },
                  {
                    "text": "Which entry fits a specific service?",
                    "kind": "action"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "society",
        "name": "Society",
        "description": "Policy and debate.",
        "rationale": "Attribution.",
        "layers": [
          {
            "id": "policy",
            "name": "Policy",
            "description": "Drug and health policy.",
            "findings": [
              {
                "id": "policy-finding",
                "name": "Policy",
                "description": "Policy.",
                "questions": [
                  {
                    "text": "What policy approaches exist, from criminalisation to harm reduction, with positions attributed?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Is the presentation neutral?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          },
          {
            "id": "definition",
            "name": "Debate",
            "description": "Definition debates.",
            "findings": [
              {
                "id": "definition-finding",
                "name": "Debate",
                "description": "Debate.",
                "questions": [
                  {
                    "text": "What debates exist about the disease model and behavioural addictions, with attribution?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits a specific behavioural addiction?",
                    "kind": "action"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "study",
        "name": "Study",
        "description": "Research and teaching.",
        "rationale": "Study.",
        "layers": [
          {
            "id": "research",
            "name": "Research",
            "description": "Research.",
            "findings": [
              {
                "id": "research-finding",
                "name": "Research",
                "description": "Research.",
                "questions": [
                  {
                    "text": "What research exists on neurobiology, epidemiology and treatment outcomes, with findings attributed?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which references are standard?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          },
          {
            "id": "teach",
            "name": "Teach",
            "description": "Teaching and language.",
            "findings": [
              {
                "id": "teach-finding",
                "name": "Teach",
                "description": "Teaching.",
                "questions": [
                  {
                    "text": "How is addiction taught, and what language do health bodies recommend to reduce stigma?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Is the language used non-stigmatising?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "openQuestions": [
    "Should each substance disorder be a separate entry?",
    "How should helplines be linked by country?",
    "The registry entry has merged aliases mixing disorders and behaviours; should they be split off?"
  ],
  "statistics": {
    "bundles": 4,
    "layers": 8,
    "findings": 8,
    "questions": 16
  }
}