{ "model": { "rank": 3297, "code": "thing-q8377", "model_id": "vr.tr.oboe", "name": "oboe", "purpose": "Enable an agent to recognise an oboe, assess its playing readiness, and identify suitable setup, use, care, or repair actions.", "family": "Thing Registry", "category": "Physical world and living systems", "status": "research-draft", "kind": "thing", "plane": "PHY", "domain": "PHY.OBJ", "industry": "", "version": "", "url": "/models/thing/q8377/", "tier": 2, "score": 88, "payload": { "layer": "wikidata", "aliases": [ "clarin", "bramevac", "Graïle", "baroque oboe", "Wiener oboe" ], "aliasCount": 5, "merged": 5, "knownIn": 88, "facets": null, "markers": [], "lexicalClass": "", "senseRank": null, "alsoRegisteredAs": "vr.tr.oboe", "source": { "dataset": "wikidata", "item": "Q8377", "url": "https://www.wikidata.org/wiki/Q8377", "license": "CC0 1.0" } }, "research": { "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-07T14:23:34Z", "providers": [ "Codex" ], "breadth": "recalled by Codex without web access - no source was read", "missingProviders": [], "pass": 2, "cost": { "grok": { "seconds": 30.7, "error": "Reading additional input from stdin...\nOpenAI Codex v0.153.3\n--------\nworkdir: R:\\02_PROJECTS\\02_Meta_Models_Platforms\\Ver.cy\\current\\thing-registry-backlog\nmodel: gpt-6-astra\nprovider: openai\napproval: never\nsandbox: read-only\nreasoning effort: none\nreasoning summaries: none\nsession id: 01a07c3f-a866-72e0-8836-908fb44567ef\n--------\nuser\nDescribe what is already known about one registered thing. Answer as JSON only, no prose around it.\n\nThing: oboe\nSense to describe: (none recorded)\nDomain code: PHY.OBJ\nAlso known as: (none)\n\n\nContext for this batch of 546 things:\n# Batch 003: 1001 registered ", "usd": 0, "recall": true }, "codex": { "seconds": 73.5, "error": "Reading additional input from stdin...\nOpenAI Codex v0.153.3\n--------\nworkdir: R:\\02_PROJECTS\\02_Meta_Models_Platforms\\Ver.cy\\current\\thing-registry-backlog\nmodel: gpt-6-astra\nprovider: openai\napproval: never\nsandbox: read-only\nreasoning effort: none\nreasoning summaries: none\nsession id: 01a07c3f-a85e-7280-8c37-32d29d710a7a\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: oboe\nRegistry id: vr.tr.oboe\nPlane / domain: PHY / PHY.OBJ\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n\n\nContext for th" } } }, "metaModel": { "id": "THING-Q8377", "registryId": "vr.tr.oboe", "name": "oboe", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.OBJ" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q8377/", "model": { "registry_id": "vr.tr.oboe", "name": "oboe", "purpose": "Enable an agent to recognise an oboe, assess its playing readiness, and identify suitable setup, use, care, or repair actions.", "definition": "An oboe is a woodwind instrument in which a double reed excites an air column in a predominantly conical bore, with finger holes and, in modern forms, keys controlling pitch.", "scope_statement": "This model covers the oboe as a kind of double-reed woodwind instrument, including the construction, reed interface, acoustic behaviour, and condition information needed to assess individual instruments without treating a manufacturer's model or a particular unit as the kind itself.", "in_scope": [ "Oboe identity, variants, and boundaries within the double-reed woodwind family", "Bore, body joints, tone holes, and key mechanism", "Reed compatibility, seating, and playing condition", "Pitch reference, playable response, and tuning behaviour", "Inspection, moisture management, storage, and repair needs" ], "out_of_scope": [ "Oboe d'amore, cor anglais, bassoon, and other separately identified instruments", "The oboist's professional identity, health, and general musical competence", "Musical works, orchestration, and performance interpretation", "Complete reed-making workflows and reed-making tool models", "Manufacturer product catalogues and individual ownership or transaction records" ], "distinguishing_features": [ "The normal sound-producing interface uses two reed blades vibrating against each other, rather than a single reed mounted against a mouthpiece.", "The air column runs through a generally conical bore with finger holes and associated keywork; a double reed alone does not establish oboe identity.", "Distinguish an ordinary oboe from cor anglais or oboe d'amore using documented instrument designation, nominal pitch, and construction together, rather than appearance alone.", "Distinguish an oboe from a bassoon through the body and bore arrangement and the way the reed connects to the instrument.", "Assess historical or simplified-key oboes against their documented variant; absence of modern keywork does not by itself exclude them." ], "characteristics": [ { "name": "Instrument variant", "kind": "category", "unit_or_values": "Modern orchestral, historical, historical reproduction, or another documented oboe variant", "why_it_matters": "Determines which construction, fingering, and performance expectations apply." }, { "name": "Body material", "kind": "category", "unit_or_values": "Documented wood species, polymer, composite, mixed construction, or unknown", "why_it_matters": "Informs inspection and material-specific care without assuming every oboe has a wooden body." }, { "name": "Keywork system and fitted mechanisms", "kind": "category", "unit_or_values": "Documented system designation and inventory of fitted keys and linkages", "why_it_matters": "Constrains available fingerings, mechanism checks, and suitable repair guidance." }, { "name": "Intended pitch reference", "kind": "measurement", "unit_or_values": "Reference note and frequency in Hz, with supporting documentation", "why_it_matters": "Helps determine suitability for an ensemble and interpret tuning measurements." }, { "name": "Reed and staple compatibility", "kind": "relation", "unit_or_values": "Instrument-to-reed assembly compatibility, including staple geometry and receiver fit", "why_it_matters": "A reed that physically enters the receiver may still produce unsuitable response or tuning." }, { "name": "Verified responding range", "kind": "measurement", "unit_or_values": "Lowest and highest demonstrated sounding notes, with reed, player, and test conditions", "why_it_matters": "Separates observed capability from advertised or assumed range." }, { "name": "Intonation profile", "kind": "measurement", "unit_or_values": "Deviation in cents by sounding note, at recorded temperature, dynamic, and pitch reference", "why_it_matters": "Reveals register-specific problems that a single tuning note can conceal." }, { "name": "Body and bore condition", "kind": "state", "unit_or_values": "No observed defect, suspected crack, confirmed crack, obstruction, moisture accumulation, or unassessed", "why_it_matters": "Determines whether playing or further inspection is appropriate." }, { "name": "Keywork and seal condition", "kind": "state", "unit_or_values": "Tested functional, suspected leak, binding key, failed spring, misregulated linkage, or unassessed", "why_it_matters": "Connects response failures to likely mechanical causes and repair needs." }, { "name": "Reed condition", "kind": "state", "unit_or_values": "Untested, responsive, overly resistant, unstable, damaged, or unsuitable under recorded conditions", "why_it_matters": "Prevents a failing reed from being mistaken for an instrument defect." } ], "affordances": [ "Identify an oboe variant and select applicable setup and care guidance.", "Check reed fit and compare response using a suitable reference reed.", "Assess key movement, tone-hole sealing, and joint alignment.", "Record tuning and response across registers under stated conditions.", "Determine readiness for playing, continued observation, or specialist repair.", "Select documented assembly, moisture-removal, transport, and storage procedures." ] }, "sources": [], "structure": { "bundles": [ { "id": "oboe-identity-and-variant", "name": "Oboe identity and variant", "description": "Establishes which oboe tradition and construction the instrument represents.", "rationale": "Modern orchestral expectations cannot be applied indiscriminately to historical or differently equipped oboes.", "layers": [ { "id": "double-reed-family-boundary", "name": "Double-reed family boundary", "description": "Separates oboes from neighbouring woodwinds using converging evidence.", "findings": [ { "id": "oboe-identification-evidence", "name": "Oboe identification evidence", "description": "Record reed interface, bore arrangement, nominal pitch, and documented designation as identification evidence.", "questions": [ { "text": "Which observed construction features support identifying this instrument as an oboe?", "kind": "definition", "id": "oboe-identification-evidence-q01" }, { "text": "What evidence excludes cor anglais, oboe d'amore, bassoon, or another double-reed instrument?", "kind": "boundary", "id": "oboe-identification-evidence-q02" } ] } ] }, { "id": "variant-and-keywork-tradition", "name": "Variant and keywork tradition", "description": "Connects the identified variant with appropriate mechanical and musical expectations.", "findings": [ { "id": "documented-oboe-configuration", "name": "Documented oboe configuration", "description": "Record the construction tradition and installed keywork without using brand or product identity as the definition of oboe.", "questions": [ { "text": "Which markings, maker documentation, or specialist assessment establish the variant and keywork system?", "kind": "provenance", "id": "documented-oboe-configuration-q01" }, { "text": "Which expectations about fingering, pitch, and range depend on this particular variant?", "kind": "boundary", "id": "documented-oboe-configuration-q02" } ] } ] } ] }, { "id": "reed-and-air-column-coupling", "name": "Reed and air-column coupling", "description": "Models the reed assembly and its interaction with the instrument.", "rationale": "Oboe response depends strongly on the reed-instrument combination, so instrument condition cannot be judged independently of reed suitability.", "layers": [ { "id": "reed-receiver-interface", "name": "Reed receiver interface", "description": "Records compatibility and seating of the reed assembly.", "findings": [ { "id": "staple-fit-and-seating", "name": "Staple fit and seating", "description": "Establish whether the staple and its covering fit the receiver securely and without damaging force.", "questions": [ { "text": "What staple dimensions and seating requirements are documented for this oboe?", "kind": "measurement", "id": "staple-fit-and-seating-q01" }, { "text": "Does the reed assembly seat securely without looseness, leakage, or excessive insertion force?", "kind": "measurement", "id": "staple-fit-and-seating-q02" } ] } ] }, { "id": "reed-response-isolation", "name": "Reed response isolation", "description": "Separates reed-related symptoms from instrument-related symptoms.", "findings": [ { "id": "comparative-reed-assessment", "name": "Comparative reed assessment", "description": "Record reed condition and controlled comparisons before attributing poor response to the oboe body or mechanism.", "questions": [ { "text": "Under the recorded preparation and playing conditions, how does the reed respond across registers and dynamics?", "kind": "measurement", "id": "comparative-reed-assessment-q01" }, { "text": "Does the symptom persist with a suitable reference reed under otherwise comparable conditions?", "kind": "action", "id": "comparative-reed-assessment-q02" } ] } ] } ] }, { "id": "bore-joints-and-keywork", "name": "Bore, joints, and keywork", "description": "Captures physical features that determine the integrity and control of the air column.", "rationale": "Cracks, joint problems, leaking pads, and linked-key regulation can cause similar playing symptoms but require different interventions.", "layers": [ { "id": "body-and-joint-integrity", "name": "Body and joint integrity", "description": "Assesses the bore, body sections, and connections present in the identified variant.", "findings": [ { "id": "air-column-integrity", "name": "Air-column integrity", "description": "Record visible damage, obstructions, and joint fit, including uncertainty where internal inspection is incomplete.", "questions": [ { "text": "Where are cracks, bore obstructions, loose joints, or difficult joint fits observed or suspected?", "kind": "measurement", "id": "air-column-integrity-q01" }, { "text": "Which observations require stopping assembly or playing and obtaining specialist inspection?", "kind": "action", "id": "air-column-integrity-q02" } ] } ] }, { "id": "tone-hole-control", "name": "Tone-hole control", "description": "Assesses finger-hole coverage, pad sealing, and the operation of fitted mechanisms.", "findings": [ { "id": "key-sealing-and-regulation", "name": "Key sealing and regulation", "description": "Record whether keys move, return, and close their intended tone holes, including dependencies between linked keys.", "questions": [ { "text": "Which pads, springs, octave vents, or linked keys fail their applicable functional checks?", "kind": "measurement", "id": "key-sealing-and-regulation-q01" }, { "text": "Does a failed note follow a particular fingering or linked-key movement, and what inspection would distinguish the likely causes?", "kind": "action", "id": "key-sealing-and-regulation-q02" } ] } ] } ] }, { "id": "pitch-response-and-playing-fit", "name": "Pitch, response, and playing fit", "description": "Relates intended musical use to demonstrated acoustic behaviour.", "rationale": "An oboe may sound while still being unsuitable for the required pitch reference, passage, register, or dynamic.", "layers": [ { "id": "pitch-reference-and-intonation", "name": "Pitch reference and intonation", "description": "Distinguishes intended pitch from observed tuning under controlled conditions.", "findings": [ { "id": "conditioned-intonation-profile", "name": "Conditioned intonation profile", "description": "Record tuning by note with reed, temperature, warm-up, dynamic, and player context.", "questions": [ { "text": "What reference note and frequency is the oboe intended to match, and what establishes that intention?", "kind": "provenance", "id": "conditioned-intonation-profile-q01" }, { "text": "What deviations in cents occur across the tested range under the recorded conditions?", "kind": "measurement", "id": "conditioned-intonation-profile-q02" } ] } ] }, { "id": "register-and-articulation-response", "name": "Register and articulation response", "description": "Assesses note initiation, register transitions, and stability for a stated playing task.", "findings": [ { "id": "task-specific-playing-readiness", "name": "Task-specific playing readiness", "description": "Evaluate response against required notes and dynamics without treating one player's result as an intrinsic instrument limit.", "questions": [ { "text": "Which required notes, attacks, or register transitions respond unreliably, and under what conditions?", "kind": "measurement", "id": "task-specific-playing-readiness-q01" }, { "text": "What further reed comparison, player assessment, or mechanical inspection is needed before judging the oboe unsuitable for the task?", "kind": "action", "id": "task-specific-playing-readiness-q02" } ] } ] } ] }, { "id": "oboe-care-and-intervention", "name": "Oboe care and intervention", "description": "Organises care decisions around the narrow bore, delicate reed, fitted keywork, and body material.", "rationale": "Appropriate care depends on construction and condition; indiscriminate cleaning or adjustment can create additional damage.", "layers": [ { "id": "moisture-and-material-care", "name": "Moisture and material care", "description": "Connects moisture removal and environmental handling to the specific instrument.", "findings": [ { "id": "documented-care-method", "name": "Documented care method", "description": "Identify approved bore-cleaning equipment and care instructions for the body material and construction.", "questions": [ { "text": "Which maker or specialist instructions specify suitable swabs, cleaning methods, and environmental handling for this oboe?", "kind": "provenance", "id": "documented-care-method-q01" }, { "text": "What action is appropriate if a swab catches, moisture obstructs a vent, or a body crack is suspected?", "kind": "action", "id": "documented-care-method-q02" } ] } ] }, { "id": "handling-storage-and-repair", "name": "Handling, storage, and repair", "description": "Defines suitable handling and the boundary between routine care and specialist work.", "findings": [ { "id": "intervention-boundary", "name": "Intervention boundary", "description": "Record safe handling guidance and qualified repair requirements for the observed mechanism and defects.", "questions": [ { "text": "How should this oboe's joints and any bridge keys be aligned during assembly without stressing the mechanism?", "kind": "action", "id": "intervention-boundary-q01" }, { "text": "Which observed problems call for routine care, and which require a qualified oboe repairer before further use?", "kind": "boundary", "id": "intervention-boundary-q02" }, { "text": "Does the case support the instrument and protect its keywork and separately stored reeds during transport?", "kind": "measurement", "id": "intervention-boundary-q03" } ] } ] } ] }, { "id": "evidence-and-external-alignment", "name": "Evidence and external alignment", "description": "What the world already says about this thing, gathered so the model can be checked against it.", "rationale": "A model that cannot be lined up against existing standards, identifiers and practice cannot be adopted by anyone who already uses them.", "layers": [ { "id": "reported-evidence", "name": "Reported evidence", "description": "Findings from the breadth pass, kept separate from the structural claims.", "findings": [ { "id": "evidence-confidence-notes", "name": "Check these first", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "This describes the instrument kind, primarily the modern soprano oboe in C, rather than a particular manufacturer's model or individual instrument.", "Length and compass are approximate; historical instruments, student models and specialist techniques differ.", "No sources were consulted; a researcher should verify model-specific range and regional mechanism details before publication." ], "questions": [ { "id": "evidence-confidence-notes-q01", "text": "Which of these check these first hold for the sense of oboe this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-kinds", "name": "Kinds and varieties", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "Baroque oboe", "Classical oboe", "Modern conservatoire-system oboe", "Thumbplate-system oboe", "Viennese oboe" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of oboe this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-standards-and-regulation", "name": "Standards and regulation", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "ISO 16, issued by the International Organization for Standardization, specifies A4 = 440 Hz as a standard musical tuning frequency; performance practice may use other reference pitches." ], "questions": [ { "id": "evidence-standards-and-regulation-q01", "text": "Which of these standards and regulation hold for the sense of oboe this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-real-world-use", "name": "Real-world use", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "Orchestral performance, including prominent melodic solos", "Providing the orchestral tuning note, conventionally A", "Chamber music, including the woodwind quintet", "Solo recital and concerto performance", "Historically informed performance using period forms or reproductions" ], "questions": [ { "id": "evidence-real-world-use-q01", "text": "Which of these real-world use hold for the sense of oboe this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-measurements", "name": "Typical measurements", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ { "quantity": "Assembled length of a modern soprano oboe", "typical_range": "Approximately 60-65", "unit": "cm" }, { "quantity": "Commonly stated modern instrument compass", "typical_range": "B-flat3 to approximately G6, with upper limits dependent on player and instrument", "unit": "scientific pitch notation" }, { "quantity": "Common contemporary ensemble tuning reference", "typical_range": "440-443", "unit": "Hz for A4" } ], "questions": [ { "id": "evidence-measurements-q01", "text": "Which of these typical measurements hold for the sense of oboe this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-failure-modes-and-hazards", "name": "Failure modes and hazards", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "Damaged, worn or poorly adjusted reeds can cause unstable pitch, difficult response or failure to sound.", "Leaking pads or misaligned key mechanisms can prevent notes from speaking reliably.", "Moisture in tone holes can cause gurgling or interrupt response.", "Rapid temperature or humidity changes can contribute to cracking in wooden bodies.", "Sustained playing can cause embouchure fatigue and hand or arm strain." ], "questions": [ { "id": "evidence-failure-modes-and-hazards-q01", "text": "Which of these failure modes and hazards hold for the sense of oboe this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-regional-variation", "name": "Regional variation", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ "Conservatoire-system instruments are widely used internationally; thumbplate and combined systems have a strong association with British playing traditions.", "The Viennese oboe preserves a distinct bore, reed and tonal tradition associated particularly with Vienna.", "Preferred reed construction, tone and tuning pitch vary between national schools, ensembles and historical-performance traditions." ], "questions": [ { "id": "evidence-regional-variation-q01", "text": "Which of these regional variation hold for the sense of oboe this model covers, and on what evidence?", "kind": "provenance" } ] }, { "id": "evidence-neighbours", "name": "Neighbouring kinds and how to tell them apart", "description": "Recalled without web access and unsourced; every item is a lead to verify.", "evidence": [ { "name": "English horn", "difference": "A larger, lower-pitched member of the oboe family, normally in F and sounding a perfect fifth below written pitch; the standard modern oboe is in C and sounds at written pitch." }, { "name": "Oboe d'amore", "difference": "An intermediate-sized family member normally in A, sounding a minor third below written pitch." }, { "name": "Clarinet", "difference": "Uses a single reed against a mouthpiece and has a predominantly cylindrical bore, whereas an oboe uses two opposing reed blades and a predominantly conical bore." }, { "name": "Bassoon", "difference": "Also uses a double reed and conical bore but has a much longer, folded air column and serves substantially lower registers." }, { "name": "Shawm", "difference": "A related double-reed instrument distinguished by its construction and historical playing traditions; it should not be treated simply as another name for the oboe." } ], "questions": [ { "id": "evidence-neighbours-q01", "text": "Which of these neighbouring kinds and how to tell them apart hold for the sense of oboe this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Does the registry intend oboe to include historical and regional oboe traditions, and where does it place the boundary with other oboe-family instruments?", "Which authoritative references should establish variant-specific keywork terminology, nominal pitch, and expected range?", "What reed and staple compatibility information is available from makers, and which dimensions require direct measurement?", "Which repeatable assessment procedure can distinguish reed, player, environmental, and mechanical contributions to poor response?", "Which manufacturer instructions or applicable standards govern care, material safety, and service assessment for each covered variant?" ], "statistics": { "bundles": 6, "layers": 11, "findings": 18, "questions": 29 } }, "draft": { "generator": "vr.draft.v3", "status": "draft-generated", "researched": false, "archetype": "device, machine or tool", "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 oboe, record what state it is in, and decide what may be done with it.", "whatItIs": "Enable an agent to recognise an oboe, assess its playing readiness, and identify suitable setup, use, care, or repair actions.", "characteristics": { "substance": "material", "origin": "manufactured", "agency": "inert", "mobility": "varies" }, "whatYouCanDoWithIt": [ "observed and measured" ], "distinguishingFeatures": [ "Names folded into this entry, which a task may need to split apart again: clarin, bramevac, Graïle, baroque oboe, Wiener oboe.", "5 finer distinctions are held as aliases rather than separate entries, because telling them apart needs a task that asks for it.", "Described in 88 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 oboe, and on what evidence are they told apart?" ], "whatItIsMadeOf": "matter you can touch", "physicalCharacter": [ "Mobility varies between examples.", "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 form, by the arrangement of its controls, and by markings - a plate, a model number, a certification mark. Form alone rarely separates two models that do very different things." ], "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": [ "clarin", "bramevac", "Graïle", "baroque oboe", "Wiener oboe" ] } ], "standing": "Described in 88 Wikipedia languages, which measures how widely it is written about rather than how important or how common it is. 5 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 oboe from another, and a oboe 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 oboe, 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 oboe, 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 oboe 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 oboe, 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 oboe, 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 oboe 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 oboe 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 oboe, 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 oboe, 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 oboe 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 oboe from the things most often confused with it.", "questions": [ { "id": "distinguishing-features-q01", "text": "What identifies and describes what distinguishes a oboe, 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 oboe, 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 oboe is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "form-and-composition", "name": "Form, composition and condition", "description": "What a oboe is made of, what shape and size it takes, and what state it is in.", "rationale": "A physical thing can be measured, and a model that cannot record its measurements cannot support any decision that depends on them.", "layers": [ { "id": "form-and-dimensions", "name": "Form and dimensions", "description": "Shape, size, mass and the ranges these take across examples.", "findings": [ { "id": "measurable-dimensions", "name": "Measurable dimensions and their units", "description": "The quantities worth recording and the units they are recorded in.", "questions": [ { "id": "measurable-dimensions-q01", "text": "What identifies and describes the dimensions of a oboe, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "measurable-dimensions-q02", "text": "Who or what asserted this about the dimensions of a oboe, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "measurable-dimensions-q03", "text": "What may an agent decide or do once the dimensions of a oboe is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "material-and-composition", "name": "Material and composition", "description": "Materials, parts and how they are put together.", "findings": [ { "id": "parts-and-materials", "name": "Parts and materials", "description": "What a oboe is built from and which parts are replaceable.", "questions": [ { "id": "parts-and-materials-q01", "text": "What identifies and describes the composition of a oboe, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "parts-and-materials-q02", "text": "Who or what asserted this about the composition of a oboe, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "parts-and-materials-q03", "text": "What may an agent decide or do once the composition of a oboe is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "condition-and-integrity", "name": "Condition and integrity", "description": "Wear, damage, health and the difference between working and broken.", "findings": [ { "id": "condition-assessment", "name": "Condition, damage and health", "description": "How the condition of a oboe is judged and by whom.", "questions": [ { "id": "condition-assessment-q01", "text": "What identifies and describes the condition of a oboe, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "condition-assessment-q02", "text": "Who or what asserted this about the condition of a oboe, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "condition-assessment-q03", "text": "What may an agent decide or do once the condition of a oboe is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "place-and-movement", "name": "Place and movement", "description": "Where a oboe is, how it got there and where it may go (varies).", "rationale": "A thing that can move needs its position recorded with a time, or every later claim about it is about a place it has left.", "layers": [ { "id": "location-and-placement", "name": "Location and placement", "description": "Position, containment and the reference frame the position is given in.", "findings": [ { "id": "position-and-frame", "name": "Position, container and reference frame", "description": "Where a oboe is, and what that position is measured against.", "questions": [ { "id": "position-and-frame-q01", "text": "What identifies and describes the location of a oboe, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "position-and-frame-q02", "text": "Who or what asserted this about the location of a oboe, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "position-and-frame-q03", "text": "What may an agent decide or do once the location of a oboe is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] }, { "id": "movement-and-transfer", "name": "Movement and transfer", "description": "How a oboe is carried, installed or relocated.", "findings": [ { "id": "movement-events", "name": "Movement events and constraints", "description": "What counts as a movement, what records it and what limits it.", "questions": [ { "id": "movement-events-q01", "text": "What identifies and describes the movement of a oboe, and in what units or vocabulary?", "kind": "definition", "answer_data": [ "identifiers", "types and classes", "values with units", "explicit unknowns" ] }, { "id": "movement-events-q02", "text": "Who or what asserted this about the movement of a oboe, by which method, and when was it true?", "kind": "provenance", "answer_data": [ "authority", "method", "evidence", "event time", "knowledge time" ] }, { "id": "movement-events-q03", "text": "What may an agent decide or do once the movement of a oboe 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 oboe 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 oboe between them.", "questions": [ { "id": "stages-and-transitions-q01", "text": "What identifies and describes the lifecycle of a oboe, 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 oboe, 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 oboe 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 oboe, how often and by whom.", "findings": [ { "id": "observation-record", "name": "Observation record", "description": "How an observation of a oboe 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 oboe, 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 oboe, 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 oboe is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] }, { "id": "function-and-principle", "name": "Function and operating principle", "description": "What oboe is for and how it achieves it.", "rationale": "Two devices with the same name can work on different principles, and the principle is what predicts failure and constrains use.", "layers": [ { "id": "intended-function", "name": "Intended function", "description": "The job it does, and the jobs it is used for anyway.", "findings": [ { "id": "function-record", "name": "Function, principle and variants", "description": "What it does, how, and which variants do it differently.", "questions": [ { "id": "function-record-q01", "text": "What function does oboe perform, on what operating principle, and which variants differ in that principle?", "kind": "definition" }, { "id": "function-record-q02", "text": "What use falls outside the intended function but happens in practice?", "kind": "boundary" } ] } ] }, { "id": "capacity-and-rating", "name": "Capacity and rating", "description": "The numbers that say what it can do and where it stops.", "findings": [ { "id": "ratings", "name": "Ratings and their conditions", "description": "Rated capacity, power, throughput and the conditions each assumes.", "questions": [ { "id": "ratings-q01", "text": "What ratings characterise oboe, in what units, and under what stated conditions?", "kind": "measurement" }, { "id": "ratings-q02", "text": "What happens beyond the rating - degradation, refusal, damage - and how is that detected?", "kind": "action" } ] } ] } ] }, { "id": "operation-and-state", "name": "Operation, controls and state", "description": "How oboe is operated and what state it is in right now.", "rationale": "An agent acting on a device needs its current state and the controls that change it, not just its specification.", "layers": [ { "id": "controls-and-modes", "name": "Controls and modes", "description": "What can be set, what that changes, and what is interlocked.", "findings": [ { "id": "control-surface", "name": "Control surface and interlocks", "description": "The settings available and the conditions that block them.", "questions": [ { "id": "control-surface-q01", "text": "What controls and modes does oboe have, and what does each change?", "kind": "definition" }, { "id": "control-surface-q02", "text": "Which actions are interlocked or forbidden in which state, and what must be true before acting?", "kind": "action" } ] } ] }, { "id": "condition-and-maintenance", "name": "Condition and maintenance", "description": "Wear, service intervals, consumables and the line between working and broken.", "findings": [ { "id": "service-record", "name": "Condition, service and consumables", "description": "What is consumed, what is serviced, and how condition is judged.", "questions": [ { "id": "service-record-q01", "text": "What consumables and service does oboe need, at what interval, and on whose authority?", "kind": "measurement" }, { "id": "service-record-q02", "text": "What evidence separates a unit that is working from one that is out of service?", "kind": "boundary" } ] } ] } ] }, { "id": "kind-model-unit", "name": "Kind, model and unit", "description": "Whether a claim about oboe is about the kind, a product line, or one physical unit.", "rationale": "This is the boundary most often got wrong for made things, and getting it wrong mixes a catalogue entry with the machine in the yard.", "layers": [ { "id": "level-of-reference", "name": "Level of reference", "description": "The three levels and what belongs at each.", "findings": [ { "id": "level-rules", "name": "What belongs to kind, model and unit", "description": "Which properties are shared by all of them and which are not.", "questions": [ { "id": "level-rules-q01", "text": "Which facts about oboe hold for every one of them, which for a model, and which only for one unit?", "kind": "boundary" }, { "id": "level-rules-q02", "text": "What identifies an individual unit, and what should an agent do when it has only the kind?", "kind": "action" } ] } ] }, { "id": "standards-and-conformity", "name": "Standards and conformity", "description": "The standards a working example must meet and who attests it.", "findings": [ { "id": "conformity", "name": "Standards, marks and attestation", "description": "Which standard applies, who certifies, and what the mark means.", "questions": [ { "id": "conformity-q01", "text": "Which standards govern oboe, issued by whom, and what does conformity actually assert?", "kind": "provenance" }, { "id": "conformity-q02", "text": "What may an agent conclude from a certification mark, and what may it not?", "kind": "boundary" } ] } ] } ] }, { "id": "provenance-and-evidence", "name": "Provenance, evidence and time", "description": "Where every claim about a oboe 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 oboe and how confident it is.", "questions": [ { "id": "claim-provenance-q01", "text": "What identifies and describes a claim about a oboe, 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 oboe, 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 oboe 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 oboe is retired without being erased.", "questions": [ { "id": "validity-and-supersession-q01", "text": "What identifies and describes the validity of a claim about a oboe, 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 oboe, 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 oboe is known, and what must it refuse?", "kind": "action", "answer_data": [ "permitted actions", "preconditions", "refusals", "escalation" ] } ] } ] } ] } ] }, "statistics": { "bundles": 8, "layers": 17, "findings": 19, "questions": 51 } } } }