{ "model": { "rank": 14750, "code": "thing-q127006", "model_id": "vr.tr.muscle-contraction", "name": "muscle contraction", "purpose": "Let an agent explain muscle contraction physiology by muscle type, relate it to exercise and health, address twitching and cramps with general information, and route concerning symptoms to care.", "family": "Thing Registry", "category": "Activities and processes", "status": "research-draft", "kind": "thing", "plane": "ACT", "domain": "ACT.PRC", "industry": "", "version": "", "url": "/models/thing/q127006/", "tier": 2, "score": 35, "payload": { "layer": "wikidata", "aliases": [ "fasciculation", "twitching", "facial muscle twitching", "migrating myoelectric complex", "Uterine tachysystole", "muscle tone", "Tik", "striated muscle contraction", "smooth muscle contraction", "tetanic contraction", "uterine contraction", "retroperistalsis", "heartbeat", "isotonic contraction", "isometric contraction", "isokinetic contraction", "obstetric labor", "ideomotor phenomenon", "Action of the heart", "Pre-labor", "eccentric contraction", "concentric contraction" ], "aliasCount": 22, "merged": 22, "knownIn": 35, "facets": null, "markers": [], "lexicalClass": "", "senseRank": null, "alsoRegisteredAs": null, "source": { "dataset": "wikidata", "item": "Q127006", "url": "https://www.wikidata.org/wiki/Q127006", "license": "CC0 1.0" } }, "research": { "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-11T15:52:29Z", "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": 1, "engine": "claude" }, "metaModel": { "id": "THING-Q127006", "registryId": "vr.tr.muscle-contraction", "name": "muscle contraction", "version": "0.2.0-wave.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "ACT.PRC" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q127006/", "model": { "registry_id": "vr.tr.muscle-contraction", "name": "muscle contraction", "purpose": "Let an agent explain muscle contraction physiology by muscle type, relate it to exercise and health, address twitching and cramps with general information, and route concerning symptoms to care.", "definition": "The activation of tension-generating sites within muscle fibres, producing force and movement, in skeletal, cardiac and smooth muscle, from voluntary movement and reflexes to heartbeat, gut motility and uterine contractions; related phenomena include muscle tone, twitching and fasciculation.", "what_it_is_for": "Movement and bodily function.", "affordances": [ "explain the mechanism of contraction", "distinguish skeletal, cardiac and smooth muscle contraction", "give general information on twitching and cramps", "route concerning symptoms to medical care" ], "distinguishing_features": [ "Force generation", "Sliding filament mechanism", "Three muscle types", "Controlled by nerves and hormones" ], "appearance": "Shortening or tensing of muscles, visible as movement or twitches.", "visual_identification": [ "Voluntary and involuntary contractions", "Twitches and fasciculations", "Muscle spasm is a sustained involuntary contraction" ], "physical_properties": [], "families_and_kinds": [ "skeletal muscle contraction", "cardiac contraction", "smooth muscle contraction including gut and uterus", "twitches and fasciculations", "muscle tone" ], "related_models": [ { "relation": "is a kind of", "target": "muscle system process", "why": "category" }, { "relation": "is powered by", "target": "hydrolysis", "why": "ATP hydrolysis" }, { "relation": "is controlled by", "target": "nervous system", "why": "control" }, { "relation": "is related to", "target": "cellular transport", "why": "calcium transport" } ], "identifiers": [], "standards_and_regulation": [ "Clinical guidelines for neuromuscular symptoms", "Obstetric guidelines for uterine activity" ], "failure_modes_and_hazards": [ "Missing serious neuromuscular disease", "Agents diagnosing", "Cramps and injuries from overexertion" ], "in_scope": [], "out_of_scope": [], "characteristics": [] }, "sources": [], "structure": { "bundles": [ { "id": "mechanism", "name": "Mechanism", "description": "How muscles contract.", "rationale": "Filaments slide.", "layers": [ { "id": "sliding", "name": "Sliding", "description": "Sliding filaments.", "findings": [ { "id": "sliding-finding", "name": "Sliding", "description": "Sliding filament.", "questions": [ { "text": "How do actin and myosin produce contraction, and what role do calcium and ATP play?", "kind": "definition" }, { "text": "How does a nerve impulse trigger it?", "kind": "definition" } ] } ] }, { "id": "types", "name": "Types", "description": "Muscle types.", "findings": [ { "id": "types-finding", "name": "Types", "description": "Muscle types.", "questions": [ { "text": "How does contraction differ in skeletal, cardiac and smooth muscle?", "kind": "definition" }, { "text": "What is muscle tone?", "kind": "definition" } ] } ] } ] }, { "id": "symptoms", "name": "Symptoms", "description": "Twitches and cramps.", "rationale": "General information.", "layers": [ { "id": "twitch", "name": "Twitch", "description": "Fasciculations.", "findings": [ { "id": "twitch-finding", "name": "Twitch", "description": "Fasciculations.", "questions": [ { "text": "What commonly causes twitching, and when should it be assessed by a doctor?", "kind": "provenance" }, { "text": "Is the user asking about their own symptoms?", "kind": "boundary" } ] } ] }, { "id": "urgent", "name": "Urgent", "description": "Warning signs.", "findings": [ { "id": "urgent-finding", "name": "Urgent", "description": "Warning signs.", "questions": [ { "text": "Are there warning signs such as progressive weakness, difficulty swallowing or breathing?", "kind": "boundary" }, { "text": "Should urgent medical care be sought?", "kind": "action" } ] } ] } ] }, { "id": "exercise", "name": "Exercise", "description": "Training.", "rationale": "Muscles adapt.", "layers": [ { "id": "training", "name": "Training", "description": "Strength and endurance.", "findings": [ { "id": "training-finding", "name": "Training", "description": "Training.", "questions": [ { "text": "How do different training types affect muscle contraction and adaptation?", "kind": "provenance" }, { "text": "How are cramps prevented?", "kind": "provenance" } ] } ] }, { "id": "injury", "name": "Injury", "description": "Strains.", "findings": [ { "id": "injury-finding", "name": "Injury", "description": "Strains.", "questions": [ { "text": "What general first aid applies to muscle strains?", "kind": "provenance" }, { "text": "When is medical assessment needed?", "kind": "boundary" } ] } ] } ] }, { "id": "clinical", "name": "Clinical", "description": "Specific contexts.", "rationale": "Specialist contexts.", "layers": [ { "id": "uterine", "name": "Uterine", "description": "Labour contractions.", "findings": [ { "id": "uterine-finding", "name": "Uterine", "description": "Uterine contractions.", "questions": [ { "text": "What are labour contractions, and when should a maternity unit be contacted, according to guidelines?", "kind": "provenance" }, { "text": "Is this an obstetric emergency?", "kind": "boundary" } ] } ] }, { "id": "gut", "name": "Gut", "description": "Gut motility.", "findings": [ { "id": "gut-finding", "name": "Gut", "description": "Gut motility.", "questions": [ { "text": "How does smooth muscle drive digestion, including the migrating motor complex?", "kind": "definition" }, { "text": "Which disorders affect motility?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Should each muscle type be a separate entry?", "How should exercise science be linked?", "How should clinical guidance be localised?" ], "statistics": { "bundles": 4, "layers": 8, "findings": 8, "questions": 16 } }, "draft": { "generator": "vr.draft.v3", "status": "draft-generated", "researched": false, "archetype": "abstract concept", "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 muscle contraction, record what state it is in, and decide what may be done with it.", "whatItIs": "Let an agent explain muscle contraction physiology by muscle type, relate it to exercise and health, address twitching and cramps with general information, and route concerning symptoms to care.", "characteristics": { "substance": "activity", "origin": "conceptual", "agency": "inert" }, "whatYouCanDoWithIt": [ "observed and measured" ], "distinguishingFeatures": [ "Names folded into this entry, which a task may need to split apart again: fasciculation, twitching, facial muscle twitching, migrating myoelectric complex, Uterine tachysystole, muscle tone, Tik, striated muscle contraction, smooth muscle contraction, tetanic contraction, uterine contraction, retroperistalsis.", "22 finer distinctions are held as aliases rather than separate entries, because telling them apart needs a task that asks for it.", "Described in 35 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 muscle contraction, and on what evidence are they told apart?" ], "whatItIsMadeOf": "something that happens over time", "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": [ "Nothing to see. What is recognised is an instance of it, and which instances count is exactly what is argued about." ], "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": [ "fasciculation", "twitching", "facial muscle twitching", "migrating myoelectric complex", "Uterine tachysystole", "muscle tone", "Tik", "striated muscle contraction", "smooth muscle contraction", "tetanic contraction", "uterine contraction", "retroperistalsis" ] } ], "standing": "Described in 35 Wikipedia languages, which measures how widely it is written about rather than how important or how common it is. 22 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 muscle contraction from another, and a muscle contraction 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 muscle contraction, 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 muscle contraction, 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 muscle contraction 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 muscle contraction, 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 muscle contraction, 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 muscle contraction 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 muscle contraction 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 muscle contraction, 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 muscle contraction, 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 muscle contraction 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 muscle contraction from the things most often confused with it.", "questions": [ { "id": "distinguishing-features-q01", "text": "What identifies and describes what distinguishes a muscle contraction, 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 muscle contraction, 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 muscle contraction 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 muscle contraction 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 muscle contraction between them.", "questions": [ { "id": "stages-and-transitions-q01", "text": "What identifies and describes the lifecycle of a muscle contraction, 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 muscle contraction, 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 muscle contraction 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 muscle contraction, how often and by whom.", "findings": [ { "id": "observation-record", "name": "Observation record", "description": "How an observation of a muscle contraction 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 muscle contraction, 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 muscle contraction, 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 muscle contraction is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "process-and-outcome", "name": "Process, inputs and outcome", "description": "How a muscle contraction proceeds, what it needs and what it leaves behind.", "rationale": "An activity is known by its steps and its results, and both have to be recordable while it is still running.", "layers": [ { "id": "steps-and-sequence", "name": "Steps and sequence", "description": "The steps of a muscle contraction, their order and what may run in parallel.", "findings": [ { "id": "steps-and-preconditions", "name": "Steps, preconditions and completion", "description": "What has to be true before each step of a muscle contraction and what marks it done.", "questions": [ { "id": "steps-and-preconditions-q01", "text": "What identifies and describes a step of a muscle contraction, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "steps-and-preconditions-q02", "text": "Who or what asserted this about a step of a muscle contraction, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "steps-and-preconditions-q03", "text": "What may an agent decide or do once a step of a muscle contraction is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "inputs-and-results", "name": "Inputs, resources and results", "description": "What a muscle contraction consumes and what it produces.", "findings": [ { "id": "inputs-and-outputs", "name": "Inputs, outputs and side effects", "description": "The resources a muscle contraction takes and the results it leaves, wanted or not.", "questions": [ { "id": "inputs-and-outputs-q01", "text": "What identifies and describes the inputs and results of a muscle contraction, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "inputs-and-outputs-q02", "text": "Who or what asserted this about the inputs and results of a muscle contraction, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "inputs-and-outputs-q03", "text": "What may an agent decide or do once the inputs and results of a muscle contraction is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "definitions-in-contest", "name": "Definitions and who holds them", "description": "What muscle contraction is taken to mean, and by whom.", "rationale": "When a field disagrees about a concept, the disagreement is the content. A model that picks one definition silently destroys the information.", "layers": [ { "id": "competing-definitions", "name": "Competing definitions", "description": "The main readings and the traditions behind them.", "findings": [ { "id": "definition-map", "name": "Definitions and their holders", "description": "Each definition with the school or body that holds it.", "questions": [ { "id": "definition-map-q01", "text": "Which definitions of muscle contraction are in use, and which tradition or body holds each?", "kind": "definition" }, { "id": "definition-map-q02", "text": "What turns on the difference between them in practice?", "kind": "boundary" } ] } ] }, { "id": "operationalisation", "name": "Operationalisation", "description": "How it is measured or applied when it has to be.", "findings": [ { "id": "operational-record", "name": "Measures and proxies", "description": "Instruments and indicators used to stand in for it.", "questions": [ { "id": "operational-record-q01", "text": "How is muscle contraction operationalised or measured in practice, and by what instrument?", "kind": "measurement" }, { "id": "operational-record-q02", "text": "What does that operationalisation leave out, and when does that matter?", "kind": "boundary" } ] } ] } ] }, { "id": "instances-and-use", "name": "Instances, use and consequence", "description": "What counts as an instance of muscle contraction and what follows from calling something that.", "rationale": "Applying a concept is an act with consequences, so a model must say what the label licenses and what it does not.", "layers": [ { "id": "instances", "name": "What counts as an instance", "description": "Clear cases, borderline cases and non-cases.", "findings": [ { "id": "instance-tests", "name": "Tests for an instance", "description": "What would settle whether something falls under it.", "questions": [ { "id": "instance-tests-q01", "text": "What would settle whether something is an instance of muscle contraction?", "kind": "boundary" }, { "id": "instance-tests-q02", "text": "Which borderline cases are argued about, and on what grounds?", "kind": "definition" } ] } ] }, { "id": "consequence", "name": "Consequence of application", "description": "Rights, duties or decisions that follow from the label.", "findings": [ { "id": "consequence-record", "name": "What the label licenses", "description": "What an agent may do once something is classified this way.", "questions": [ { "id": "consequence-record-q01", "text": "What follows practically once something is treated as muscle contraction?", "kind": "action" }, { "id": "consequence-record-q02", "text": "What must an agent not infer from the label alone?", "kind": "action" } ] } ] } ] }, { "id": "provenance-and-evidence", "name": "Provenance, evidence and time", "description": "Where every claim about a muscle contraction 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 muscle contraction and how confident it is.", "questions": [ { "id": "claim-provenance-q01", "text": "What identifies and describes a claim about a muscle contraction, 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 muscle contraction, 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 muscle contraction 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 muscle contraction is retired without being erased.", "questions": [ { "id": "validity-and-supersession-q01", "text": "What identifies and describes the validity of a claim about a muscle contraction, 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 muscle contraction, 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 muscle contraction is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] } ] }, "statistics": { "bundles": 6, "layers": 12, "findings": 14, "questions": 38 } } } }