{
  "vercy": "1.0-draft",
  "publication": {
    "status": "research-draft",
    "adjudicationStatus": "unreviewed",
    "publishableCanonical": false,
    "generatedAt": "2026-09-11T22:38:06Z",
    "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": 2,
    "engine": "claude",
    "enrichment": {
      "pass": 3,
      "engine": "claude",
      "producedAt": "2026-10-05T23:50:00Z",
      "ingestedAt": "2026-10-05T20:46:29+00:00",
      "fields": [
        "agent_conduct",
        "ethics",
        "owners"
      ]
    },
    "gate": {
      "passed": true,
      "version": "1.0",
      "at": "2026-10-06T19:52:02+00:00",
      "evidence": [
        "completeness 1.00",
        "sense: Wikidata description",
        "2 live sources",
        "review by codex: pass"
      ]
    }
  },
  "metaModel": {
    "id": "THING-Q7632070",
    "registryId": "vr.tr.substance-use-disorder",
    "name": "substance use disorder",
    "version": "0.2.0-wave.2",
    "entryKind": "thing",
    "family": "Thing Registry",
    "domain": [
      "XCT.STA"
    ],
    "status": "research-draft"
  },
  "canonicalUrl": "https://ver.cy/models/thing/q7632070/",
  "model": {
    "registry_id": "vr.tr.substance-use-disorder",
    "name": "substance use disorder",
    "purpose": "Let an agent explain substance use disorders as treatable health conditions in general terms, route crises and withdrawal risks to care, describe treatment and harm reduction with attribution, and support people and families without stigma.",
    "definition": "A pattern of harmful use of a substance such as alcohol, cannabis, opioids, stimulants or others that leads to impairment, distress or dependence, diagnosed by clinical criteria and ranging from mild to severe, with related health effects such as alcohol-related organ damage and memory disorders; substance use disorders are treatable health conditions addressed through medical, psychological and social support and harm reduction.",
    "what_it_is_for": "Harmful patterns of substance use.",
    "affordances": [
      "explain the condition without stigma",
      "route crises and withdrawal risks to care",
      "describe treatment and harm reduction",
      "support people and families"
    ],
    "distinguishing_features": [
      "Health condition",
      "Clinical criteria",
      "Treatable",
      "Stigma-sensitive"
    ],
    "appearance": "Not visible as such; patterns of use, impairment and dependence.",
    "visual_identification": [
      "Harmful use causing impairment or dependence",
      "Mild to severe",
      "Occasional use without harm is not a disorder"
    ],
    "physical_properties": [],
    "families_and_kinds": [
      "alcohol use disorder",
      "cannabis use disorder",
      "opioid use disorder",
      "stimulant use disorder",
      "other substance use disorders"
    ],
    "related_models": [
      {
        "relation": "is a kind of",
        "target": "substance-related disorder",
        "why": "category"
      },
      {
        "relation": "is related to",
        "target": "liver cirrhosis",
        "why": "alcohol-related harm"
      },
      {
        "relation": "is related to",
        "target": "abstinence",
        "why": "one recovery approach"
      },
      {
        "relation": "is related to",
        "target": "intoxication",
        "why": "acute effects"
      }
    ],
    "identifiers": [],
    "standards_and_regulation": [
      "Clinical guidelines for substance use disorders",
      "Drug and alcohol policy and law",
      "Harm reduction service standards"
    ],
    "failure_modes_and_hazards": [
      "Dangerous unsupervised withdrawal",
      "Overdose",
      "Agents moralising or giving individual medical advice"
    ],
    "in_scope": [],
    "out_of_scope": [],
    "characteristics": [],
    "agent_conduct": {
      "may": [
        "Give general information about substance use disorders and treatment options from reliable sources.",
        "Point people to support services and crisis lines in their area.",
        "Use non-stigmatising language when describing people with the condition."
      ],
      "must_not": [
        "Advise a person to stop a substance abruptly without medical supervision where withdrawal can be dangerous.",
        "Assist in obtaining substances or in using them in more harmful ways.",
        "Moralise about or shame people with the condition.",
        "Disclose a person's substance use history without consent."
      ],
      "requires_human": [
        "Any decision about medically supervised withdrawal or medication.",
        "Responding to a possible overdose or immediate danger."
      ]
    },
    "ethics": {
      "considerations": [
        "Stigma keeps people from seeking help.",
        "Substance use records can cost people jobs, custody or liberty if disclosed."
      ],
      "affected_parties": [
        "People with the condition",
        "Families",
        "Health and support workers"
      ]
    },
    "owners": {
      "steward": "Nobody owns the condition; each person's care team and health record hold their care.",
      "master_systems": [
        "Patient health records"
      ]
    }
  },
  "sources": [
    {
      "id": "wikidata",
      "title": "Wikidata item Q7632070: substance use disorder",
      "url": "https://www.wikidata.org/wiki/Q7632070",
      "url_status": "live",
      "what_it_supports": "identity and sense of the item",
      "checked_by": "wikidata-api"
    },
    {
      "id": "wikipedia-en",
      "title": "Wikipedia: Substance use disorder",
      "url": "https://en.wikipedia.org/wiki/Substance_use_disorder",
      "url_status": "live",
      "what_it_supports": "general description of the item",
      "checked_by": "wikidata-api sitelink"
    }
  ],
  "structure": {
    "bundles": [
      {
        "id": "urgent",
        "name": "Urgent",
        "description": "Crisis and withdrawal.",
        "rationale": "Routing.",
        "layers": [
          {
            "id": "emergency",
            "name": "Emergency",
            "description": "Overdose and crisis.",
            "findings": [
              {
                "id": "emergency-finding",
                "name": "Emergency",
                "description": "Emergencies.",
                "questions": [
                  {
                    "text": "Are there signs of overdose, severe withdrawal such as delirium tremens, or a mental health crisis needing emergency care now?",
                    "kind": "boundary"
                  },
                  {
                    "text": "Should emergency services be called, and what first aid applies, such as naloxone?",
                    "kind": "action"
                  }
                ]
              }
            ]
          },
          {
            "id": "withdrawal",
            "name": "Withdrawal",
            "description": "Stopping safely.",
            "findings": [
              {
                "id": "withdrawal-finding",
                "name": "Withdrawal",
                "description": "Withdrawal.",
                "questions": [
                  {
                    "text": "Which substances require medically supervised withdrawal, according to guidelines?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Is the user planning to stop and needing professional support?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "understand",
        "name": "Understand",
        "description": "The condition.",
        "rationale": "Without stigma.",
        "layers": [
          {
            "id": "definition",
            "name": "Definition",
            "description": "What a substance use disorder is.",
            "findings": [
              {
                "id": "definition-finding",
                "name": "Definition",
                "description": "Definition.",
                "questions": [
                  {
                    "text": "How are substance use disorders defined and graded by clinical criteria, and how does dependence differ from use?",
                    "kind": "definition"
                  },
                  {
                    "text": "Which language avoids stigma, according to health bodies and people with lived experience?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          },
          {
            "id": "effects",
            "name": "Effects",
            "description": "Health effects.",
            "findings": [
              {
                "id": "effects-finding",
                "name": "Effects",
                "description": "Effects.",
                "questions": [
                  {
                    "text": "What health effects are documented for this substance, such as alcohol-related liver, heart and memory disorders?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Is the user asking for individual medical advice?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "treat",
        "name": "Treat",
        "description": "Treatment and recovery.",
        "rationale": "Attribution.",
        "layers": [
          {
            "id": "treatment",
            "name": "Treatment",
            "description": "Treatment approaches.",
            "findings": [
              {
                "id": "treatment-finding",
                "name": "Treatment",
                "description": "Treatment.",
                "questions": [
                  {
                    "text": "Which treatments, from medication and psychological therapies to peer support, do guidelines describe, and what is the evidence?",
                    "kind": "provenance"
                  },
                  {
                    "text": "How are abstinence and harm reduction approaches compared, with positions attributed?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          },
          {
            "id": "access",
            "name": "Access",
            "description": "Finding help.",
            "findings": [
              {
                "id": "access-finding",
                "name": "Access",
                "description": "Help.",
                "questions": [
                  {
                    "text": "Which services, helplines and support groups exist here for people and families?",
                    "kind": "provenance"
                  },
                  {
                    "text": "How can someone support a family member?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "society",
        "name": "Society",
        "description": "Policy and research.",
        "rationale": "Context.",
        "layers": [
          {
            "id": "policy",
            "name": "Policy",
            "description": "Policy debates.",
            "findings": [
              {
                "id": "policy-finding",
                "name": "Policy",
                "description": "Policy.",
                "questions": [
                  {
                    "text": "What do evaluations say about drug and alcohol policies, and what are the attributed positions in debates?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Is the presentation neutral?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          },
          {
            "id": "research",
            "name": "Research",
            "description": "Research.",
            "findings": [
              {
                "id": "research-finding",
                "name": "Research",
                "description": "Research.",
                "questions": [
                  {
                    "text": "What are current research directions in substance use disorders?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which misconceptions arise?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "openQuestions": [
    "Should each substance disorder be a separate entry?",
    "How should helplines be localised?",
    "How should policy debates be attributed?"
  ],
  "statistics": {
    "bundles": 4,
    "layers": 8,
    "findings": 8,
    "questions": 16
  }
}
