{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.utility-quantity","code":"thing-utility-quantity","url":"https://ver.cy/models/thing/utility-quantity/","name":"utility","alternateNames":["marginal utility"],"kind":"thing","status":"published","version":"0.2.0-wave.3","language":"en","classifiers":{"family":"Thing Registry","category":"Cross-cutting context","entryKind":"noun.quantity","plane":"XCT","domain":["XCT.QTY"],"industry":[],"navPath":"","tags":[],"facets":{"substance":"abstract","origin":"conceptual","agency":"inert","mobility":"not-applicable","scale":"not-applicable","affordances":["observable"]}},"whatItIs":"In economics, a measure of the satisfaction or value that a consumer derives from goods, services or outcomes, which agents are modelled as maximising when choosing, with marginal utility as the additional satisfaction from one more unit and the principle of diminishing marginal utility explaining demand; utility may be ordinal or cardinal, underlies expected utility theory under uncertainty and welfare economics, and is the subject of debates over measurement and interpersonal comparison.","purpose":"Let an agent explain utility in economics, relay marginal utility, ordinal and cardinal concepts and expected utility theory from standard references, describe its role in welfare economics and behavioural critiques, and distinguish the economic sense from utilities as services.","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["Maximisation assumption","Diminishing marginal utility","Ordinal versus cardinal","Foundation of demand theory"],"structure":{"bundles":[{"id":"understand","name":"Understand","description":"What utility is.","layers":[{"id":"definition","name":"Definition","description":"Definition and kinds.","findings":[{"id":"definition-finding","name":"Definition","description":"Definition.","questions":[{"text":"What is utility in economics, and how do ordinal and cardinal utility differ?","kind":"definition"},{"text":"Is the question about economic utility, public utilities or utilitarian ethics?","kind":"boundary"}]}]},{"id":"marginal","name":"Marginal","description":"Marginal utility.","findings":[{"id":"marginal-finding","name":"Marginal","description":"Marginal.","questions":[{"text":"What is marginal utility, and how does diminishing marginal utility explain demand?","kind":"definition"},{"text":"Which entry fits marginal utility?","kind":"action"}]}]}]},{"id":"theory","name":"Theory","description":"Theory.","layers":[{"id":"functions","name":"Functions","description":"Utility functions.","findings":[{"id":"functions-finding","name":"Functions","description":"Functions.","questions":[{"text":"How are utility functions specified and used in consumer theory?","kind":"provenance"},{"text":"Which references are standard?","kind":"provenance"}]}]},{"id":"uncertainty","name":"Uncertainty","description":"Expected utility.","findings":[{"id":"uncertainty-finding","name":"Uncertainty","description":"Uncertainty.","questions":[{"text":"What is expected utility theory, and what paradoxes and critiques exist, with positions attributed?","kind":"provenance"},{"text":"Which entry fits expected utility?","kind":"action"}]}]}]},{"id":"welfare","name":"Welfare","description":"Welfare and behaviour.","layers":[{"id":"welfare","name":"Welfare","description":"Welfare economics.","findings":[{"id":"welfare-finding","name":"Welfare","description":"Welfare.","questions":[{"text":"How does utility enter welfare economics and social choice, and what are the debates on interpersonal comparison?","kind":"provenance"},{"text":"Which sources are cited?","kind":"provenance"}]}]},{"id":"behavioural","name":"Behavioural","description":"Behavioural critiques.","findings":[{"id":"behavioural-finding","name":"Behavioural","description":"Behavioural.","questions":[{"text":"How do prospect theory and behavioural economics challenge utility maximisation, with findings attributed?","kind":"provenance"},{"text":"Is the presentation neutral?","kind":"boundary"}]}]}]},{"id":"context","name":"Context","description":"History and ethics.","layers":[{"id":"history","name":"History","description":"History.","findings":[{"id":"history-finding","name":"History","description":"History.","questions":[{"text":"How did the concept develop from Bentham and the marginalists to Samuelson and von Neumann?","kind":"provenance"},{"text":"Which entry fits the history of economic thought?","kind":"action"}]}]},{"id":"ethics","name":"Ethics","description":"Utilitarianism.","findings":[{"id":"ethics-finding","name":"Ethics","description":"Ethics.","questions":[{"text":"How does economic utility relate to utilitarian ethics?","kind":"provenance"},{"text":"Which entry fits utilitarianism?","kind":"action"}]}]}]}]},"agentConduct":{"may":["Explain utility, marginal utility and their role in economic models.","Note the assumptions and limits of utility-based models when presenting results."],"mustNot":["Present utility as a measured quantity of a real person's happiness.","Use utility comparisons to rank the worth of people or groups.","Optimise a user's choices for a third party's utility while claiming to serve the user.","Hide value judgements built into a utility function used in policy."],"requiresHuman":["Using utility-based models in decisions on public spending, health or welfare."]},"ethics":{"considerations":["Utility models can quietly weigh some people's welfare less than others.","Assuming rational utility maximisation can blame people for structural harms."],"affectedParties":["People affected by policy","Consumers","Low-income households"]},"owners":{"steward":"Nobody owns a concept of economics.","roles":[],"masterSystems":[]},"relations":[{"target":"oewn-13598374-n","type":"parent","note":"registry parent class"},{"target":"quantity","type":"related","note":"in registry terms"},{"target":"consumer choice","type":"related","note":"in economic models"},{"target":"utility function","type":"related","note":"mathematically"},{"target":"public utility","type":"related","note":"a service provider"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.utility-quantity","Open English WordNet: oewn-13601261-n"]},"properties":{"applicability":"not-applicable","items":[]},"recognition":{"applicability":"optional","items":["Measure of satisfaction to be maximised in choice","Marginal, ordinal, cardinal and expected utility","Public utilities are service companies; utilitarianism is the ethical theory","Not a visible object; a function in economic models."]},"capabilities":{"applicability":"required","items":["explain the concept and kinds","relay marginal and expected utility","describe welfare and behavioural debates","distinguish from other senses"]},"hazards":{"applicability":"required","items":["Treating utility as directly measurable","Interpersonal comparison errors","Confusing senses of utility","Ignoring behavioural evidence"]},"interfaces":{"applicability":"required","items":["No regulation; conventions of economic theory"]},"context":{"applicability":"required","items":["Modelling choice and welfare.","total and marginal utility","ordinal and cardinal utility","expected utility under uncertainty","indirect utility and utility functions","social welfare functions","behavioural alternatives such as prospect theory"]}},"sources":[{"title":"Open English WordNet 2024, synset oewn-13601261-n","url":"https://en-word.net/id/oewn-13601261-n","note":"sense and gloss of the concept"},{"title":"Wiktionary: utility","url":"https://en.wiktionary.org/wiki/utility","note":"word senses and usage"}],"openQuestions":["Should marginal utility and expected utility be separate entries?","How should economics references be linked?","How should the utilitarian ethics link be recorded?"],"resources":{"spec":"/models/things/publications/thing-utility-quantity/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-utility-quantity/spec.json"],"providers":["Claude"],"researchStatus":"unreviewed","generatedAt":"2026-09-13T00:57:20Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"not-applicable","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-07T12:16:35+00:00: completeness 1.00; sense: WordNet gloss; 2 live sources; review by codex: pass","interaction.properties":"Plane XCT: no invented physical properties."},"score":1.0}}