{ "model": { "rank": 2923, "code": "thing-q51290", "model_id": "vr.tr.harmonica", "name": "harmonica", "purpose": "Enable an AI agent to recognise a harmonica, assess its playing condition and suitability, and decide whether it can be played, cleaned, adjusted or repaired.", "family": "Thing Registry", "category": "Physical world and living systems", "status": "research-draft", "kind": "thing", "plane": "PHY", "domain": "PHY.OBJ", "industry": "", "version": "", "url": "/models/thing/q51290/", "tier": 2, "score": 94, "payload": { "layer": "wikidata", "aliases": [ "Biram", "bajón", "Richter-tuned harmonica", "bass harmonica", "chromatic harmonica", "Tremolo harmonica", "diatonic harmonica" ], "aliasCount": 7, "merged": 7, "knownIn": 94, "facets": null, "markers": [], "lexicalClass": "", "senseRank": null, "alsoRegisteredAs": "vr.tr.harmonica", "source": { "dataset": "wikidata", "item": "Q51290", "url": "https://www.wikidata.org/wiki/Q51290", "license": "CC0 1.0" } }, "research": { "vercy": "1.0-draft", "publication": { "status": "research-draft", "adjudicationStatus": "unreviewed", "publishableCanonical": false, "generatedAt": "2026-09-07T13:42:25Z", "providers": [ "Codex", "Grok" ], "missingProviders": [], "pass": 2, "cost": { "grok": { "usd": 0.00166464, "turns": 1, "seconds": 10, "error": null }, "codex": { "seconds": 83.4, "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: 01a07c19-d569-74e3-b818-c7953ef89c6b\n--------\nuser\nYou are drafting a Vercy meta-model for one registered thing. Answer as JSON only, no prose around it.\n\nThing: harmonica\nRegistry id: vr.tr.harmonica\nPlane / domain: PHY / PHY.OBJ\nRegistry definition: (none recorded)\nNames folded into this entry: (none)\n\nA Ver" } } }, "metaModel": { "id": "THING-Q51290", "registryId": "vr.tr.harmonica", "name": "harmonica", "version": "0.1.0-research.1", "entryKind": "thing", "family": "Thing Registry", "domain": [ "PHY.OBJ" ], "status": "research-draft" }, "canonicalUrl": "https://ver.cy/models/thing/q51290/", "model": { "registry_id": "vr.tr.harmonica", "name": "harmonica", "purpose": "Enable an AI agent to recognise a harmonica, assess its playing condition and suitability, and decide whether it can be played, cleaned, adjusted or repaired.", "definition": "A small free-reed wind instrument played by blowing and drawing air through a row of holes in a mouthpiece, each hole sounding one or two reeds fixed to plates inside a comb; made in diatonic, chromatic, tremolo, octave, bass and chord forms.", "scope_statement": "This model owns an individual harmonica as a mouth-played free-reed instrument, including its air passages, reed arrangement, pitch layout, controls, playing response, condition and instrument-specific care constraints.", "in_scope": [ "Harmonica type, identifying marks and fitted configuration", "Mouthpiece, comb, chambers, reed plates, covers and any slide mechanism", "Hole-to-note mapping across blowing, drawing and available control positions", "Air sealing, reed response, pitch stability and unintended sounds", "Mouth-contact cleanliness, material condition and permitted maintenance" ], "out_of_scope": [ "The player's physiology, health and general musical skill", "Compositions, arrangements and performance events", "Microphones, amplifiers and effects equipment", "Cases, racks and holders as independently managed accessories", "Retail offers, ownership transactions and market valuation" ], "distinguishing_features": [ "Sound is produced by airflow exciting reeds rather than by a vibrating string, lip buzz or an edge-tone whistle.", "The player selects air passages through a mouthpiece or exposed row of holes, rather than selecting notes primarily through a keyboard.", "Its note layout can be described by mouth position and breath direction, with any slide or other control recorded as an additional selector.", "A complete playable assembly combines air chambers and reeds with a mouth-contact interface; a loose reed plate or comb is a component rather than a complete harmonica.", "A slide button alone does not establish that it is a chromatic harmonica; the actual pitch layout and routing must support that classification." ], "characteristics": [ { "name": "Instrument family", "kind": "category", "unit_or_values": "diatonic; slide chromatic; tremolo; octave; bass; chord; other; unresolved", "why_it_matters": "Determines which layout, response and control expectations are appropriate." }, { "name": "Mouthpiece hole arrangement", "kind": "category", "unit_or_values": "Hole count, row count and physical grouping", "why_it_matters": "Establishes how playable positions are identified without assuming one hole equals one note." }, { "name": "Installed pitch layout", "kind": "relation", "unit_or_values": "Mouthpiece position × breath direction × control position → sounding pitch or pitches", "why_it_matters": "Supports recognition of tuning variants, missing notes and suitable musical uses." }, { "name": "Marked key and tuning designation", "kind": "category", "unit_or_values": "Observed inscription or documented designation; absent; unresolved", "why_it_matters": "Provides an identification clue that must be checked against the installed layout." }, { "name": "Pitch deviation", "kind": "measurement", "unit_or_values": "Cents from a stated target under recorded playing conditions", "why_it_matters": "Separates measured tuning behaviour from an unsupported judgement that the instrument is out of tune." }, { "name": "Reed response", "kind": "state", "unit_or_values": "Responsive; delayed; intermittent; silent; rattling; untested, by playable position", "why_it_matters": "Localises faults and establishes whether intended notes can be produced reliably." }, { "name": "Air-path sealing", "kind": "state", "unit_or_values": "No problematic leakage observed; leakage suspected; leakage localised; untested", "why_it_matters": "Helps distinguish air loss from reed or technique problems." }, { "name": "Wetted and mouth-contact materials", "kind": "category", "unit_or_values": "Observed or documented materials and coatings by component; unknown", "why_it_matters": "Constrains cleaning, soaking, drying and mouth-contact suitability." }, { "name": "Service-part compatibility", "kind": "relation", "unit_or_values": "Instrument configuration → verified compatible reed plates, reeds, valves, slides and fasteners", "why_it_matters": "Prevents repairs based only on similar appearance or a shared brand name." } ], "affordances": [ "Select a harmonica for a required pitch layout, range and playing technique.", "Inspect and test individual blow, draw and control-dependent responses.", "Identify positions supporting bends or other pitch alterations when demonstrated.", "Clean and dry accessible parts using a method compatible with the fitted materials.", "Adjust, repair or replace serviceable parts where the procedure and compatibility are established.", "Withhold playing or servicing when mouth-contact condition, loose parts or unresolved damage prevents a supported action." ] }, "sources": [], "structure": { "bundles": [ { "id": "identity-and-configuration", "name": "Identity and configuration", "description": "Establishes what kind of harmonica is present and whether its current assembly matches its apparent identity.", "rationale": "Family labels and cover markings do not establish the tuning or components currently installed.", "layers": [ { "id": "family-recognition", "name": "Family recognition", "description": "Classifies the instrument from its air interface, reed arrangement and controls.", "findings": [ { "id": "supported-harmonica-type", "name": "Supported harmonica type", "description": "Record the observed features supporting a family classification and any conflicting evidence.", "questions": [ { "text": "Which mouthpiece, reed-pairing and control features support the proposed harmonica family?", "kind": "definition", "id": "supported-harmonica-type-q01" }, { "text": "Does this object form a playable harmonica, or is it a component or a neighbouring free-reed instrument?", "kind": "boundary", "id": "supported-harmonica-type-q02" } ] } ] }, { "id": "assembly-identity", "name": "Assembly identity", "description": "Connects identifying marks to the actual fitted comb, reed plates and covers.", "findings": [ { "id": "marked-versus-fitted-configuration", "name": "Marked versus fitted configuration", "description": "Record inscriptions, documented model identity and evidence of replacement or customisation.", "questions": [ { "text": "What maker, model, key or tuning marks are present, and what evidence links them to this assembly?", "kind": "provenance", "id": "marked-versus-fitted-configuration-q01" }, { "text": "Have reed plates, covers, comb or tuning been changed so that external markings no longer describe the instrument?", "kind": "provenance", "id": "marked-versus-fitted-configuration-q02" } ] } ] } ] }, { "id": "note-layout-and-selection", "name": "Note layout and selection", "description": "Describes which pitches the harmonica offers and how the player selects them.", "rationale": "Key and hole count alone cannot determine playable notes, chords or control behaviour.", "layers": [ { "id": "breath-position-map", "name": "Breath and position map", "description": "Maps physical playing positions to their intended blow and draw outputs.", "findings": [ { "id": "installed-note-map", "name": "Installed note map", "description": "Record pitches and octaves by mouthpiece position, including simultaneous reeds and intentional gaps.", "questions": [ { "text": "Which intended pitches and octaves correspond to each position when blowing and drawing?", "kind": "definition", "id": "installed-note-map-q01" }, { "text": "Where does one playing position sound multiple reeds, and are their intended relationships unison, tremolo, octave or chordal?", "kind": "definition", "id": "installed-note-map-q02" } ] } ] }, { "id": "selectors-and-range", "name": "Selectors and range", "description": "Describes how slides or other fitted selectors change available notes.", "findings": [ { "id": "control-dependent-pitches", "name": "Control-dependent pitches", "description": "Record selector states, their pitch-routing effects and the resulting available range.", "questions": [ { "text": "For each fitted selector position, which blow and draw pitches become available?", "kind": "measurement", "id": "control-dependent-pitches-q01" }, { "text": "Which requested notes or chords can this layout supply without relying on an unverified pitch-altering technique?", "kind": "action", "id": "control-dependent-pitches-q02" } ] } ] } ] }, { "id": "playing-response-and-tuning", "name": "Playing response and tuning", "description": "Assesses how the fitted reeds respond and how their sounding pitches relate to intended tuning.", "rationale": "A nominally correct layout can still be difficult to sound, unstable or unsuitable for the intended musical use.", "layers": [ { "id": "reed-speaking-behaviour", "name": "Reed speaking behaviour", "description": "Examines note onset and sustained sound under recorded test conditions.", "findings": [ { "id": "position-specific-response", "name": "Position-specific response", "description": "Record silent, delayed, intermittent or noisy responses by position and breath direction.", "questions": [ { "text": "Which positions speak reliably under the documented test method, and which produce silence, delay, choking or unintended noise?", "kind": "measurement", "id": "position-specific-response-q01" }, { "text": "What repeat test or inspection can distinguish a reed fault from leakage, moisture or the player's technique?", "kind": "action", "id": "position-specific-response-q02" } ] } ] }, { "id": "pitch-and-expression", "name": "Pitch and expression", "description": "Separates intended tuning, measured deviation and deliberate pitch alteration.", "findings": [ { "id": "tuning-and-altered-note-evidence", "name": "Tuning and altered-note evidence", "description": "Record tuning targets and measured behaviour without treating every deviation from equal temperament as a defect.", "questions": [ { "text": "How far do measured pitches deviate from the stated tuning targets, and under what breath and measurement conditions?", "kind": "measurement", "id": "tuning-and-altered-note-evidence-q01" }, { "text": "Which bends, overblows or overdraws have been demonstrated on this instrument, at which positions and by what test?", "kind": "measurement", "id": "tuning-and-altered-note-evidence-q02" }, { "text": "Are observed pitch offsets intentional features of its temperament or paired-reed tuning, or unresolved deviations?", "kind": "boundary", "id": "tuning-and-altered-note-evidence-q03" } ] } ] } ] }, { "id": "air-path-and-mechanical-condition", "name": "Air path and mechanical condition", "description": "Assesses the physical structures that route air and allow reeds and controls to move.", "rationale": "Leakage, obstruction and mechanical interference can produce similar playing symptoms but require different interventions.", "layers": [ { "id": "chambers-and-seals", "name": "Chambers and seals", "description": "Examines comb chambers, mating surfaces and fitted valves for air-routing problems.", "findings": [ { "id": "air-routing-integrity", "name": "Air-routing integrity", "description": "Record cracks, distortion, debris, suspected leakage and valve behaviour where valves are fitted.", "questions": [ { "text": "Where is air escaping or becoming obstructed, and what observation localises the problem?", "kind": "measurement", "id": "air-routing-integrity-q01" }, { "text": "Are comb surfaces, reed-plate joints and any fitted valves intact and functioning under the test conditions?", "kind": "measurement", "id": "air-routing-integrity-q02" } ] } ] }, { "id": "moving-parts-and-clearance", "name": "Moving parts and clearance", "description": "Examines reed clearance, cover interference, fasteners and any slide mechanism.", "findings": [ { "id": "mechanical-interference", "name": "Mechanical interference", "description": "Record loose, obstructed or damaged parts and whether they affect playing or require inspection before use.", "questions": [ { "text": "Do reeds move without observed contact, and do covers or loose fasteners create interference or rattling?", "kind": "measurement", "id": "mechanical-interference-q01" }, { "text": "If a slide is fitted, does it travel and return reliably while selecting the expected air passages?", "kind": "measurement", "id": "mechanical-interference-q02" }, { "text": "Which observed defects require withholding play until loose parts, sharp edges or mechanical damage are addressed?", "kind": "action", "id": "mechanical-interference-q03" } ] } ] } ] }, { "id": "mouth-contact-care-and-service", "name": "Mouth-contact care and service", "description": "Determines appropriate cleaning, drying and repair actions for this harmonica's construction and condition.", "rationale": "Internal moisture exposure and delicate reeds make care decisions dependent on materials, access and fitted components.", "layers": [ { "id": "cleanliness-and-material-limits", "name": "Cleanliness and material limits", "description": "Records mouth-contact condition and the evidence supporting a cleaning method.", "findings": [ { "id": "supported-cleaning-method", "name": "Supported cleaning method", "description": "Connect observed residue, corrosion and moisture to material-compatible cleaning and drying instructions.", "questions": [ { "text": "What residue, retained moisture, corrosion or coating damage is visible at the mouthpiece and accessible internal surfaces?", "kind": "measurement", "id": "supported-cleaning-method-q01" }, { "text": "Which documented cleaning and drying methods apply to the fitted comb, reeds, valves, coatings and adhesives?", "kind": "provenance", "id": "supported-cleaning-method-q02" }, { "text": "What cleaning action is supported by that evidence, and what unresolved material information prevents a method from being selected?", "kind": "action", "id": "supported-cleaning-method-q03" } ] } ] }, { "id": "repair-and-return-to-play", "name": "Repair and return to play", "description": "Defines feasible servicing and the checks required after intervention.", "findings": [ { "id": "verified-service-path", "name": "Verified service path", "description": "Record the supported repair, compatible parts and evidence that the repaired instrument performs as intended.", "questions": [ { "text": "Which adjustment or replacement is supported for the diagnosed fault, and what confirms part and procedure compatibility?", "kind": "action", "id": "verified-service-path-q01" }, { "text": "After servicing, which affected notes, seals, controls and mouth-contact surfaces must be checked before returning the harmonica to play?", "kind": "action", "id": "verified-service-path-q02" } ] } ] } ] }, { "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-kinds", "name": "Kinds and varieties", "description": "Reported by the breadth pass; each item needs checking against its source before it becomes normative.", "evidence": [ "diatonic harmonica", "chromatic harmonica", "tremolo harmonica", "octave harmonica" ], "questions": [ { "id": "evidence-kinds-q01", "text": "Which of these kinds and varieties hold for the sense of harmonica this model covers, and on what evidence?", "kind": "provenance" } ] } ] } ] } ] }, "openQuestions": [ "Should ensemble bass and chord harmonicas, double-sided instruments and unusual selector designs remain variants within this model, and which require additional layers?", "What repeatable playing test can separate instrument faults from player-dependent response without imposing unsupported universal breath-pressure thresholds?", "Which authoritative tuning references cover temperament, pitch reference and intentional paired-reed offsets across the included harmonica families?", "Which manufacturer-supported care procedures apply to different comb materials, coatings, valves and adhesives, especially when the construction is undocumented?", "What evidence is sufficient to recommend reed adjustment or replacement rather than specialist assessment for a particular construction?" ], "statistics": { "bundles": 6, "layers": 11, "findings": 11, "questions": 24 } }, "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 harmonica, record what state it is in, and decide what may be done with it.", "whatItIs": "Enable an AI agent to recognise a harmonica, assess its playing condition and suitability, and decide whether it can be played, cleaned, adjusted or repaired.", "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: Biram, bajón, Richter-tuned harmonica, bass harmonica, chromatic harmonica, Tremolo harmonica, diatonic harmonica.", "7 finer distinctions are held as aliases rather than separate entries, because telling them apart needs a task that asks for it.", "Described in 94 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 harmonica, 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": [ "Biram", "bajón", "Richter-tuned harmonica", "bass harmonica", "chromatic harmonica", "Tremolo harmonica", "diatonic harmonica" ] } ], "standing": "Described in 94 Wikipedia languages, which measures how widely it is written about rather than how important or how common it is. 7 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 harmonica from another, and a harmonica 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 harmonica, 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 harmonica, 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 harmonica 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 harmonica, 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 harmonica, 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 harmonica 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 harmonica 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 harmonica, 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 harmonica, 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 harmonica 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 harmonica from the things most often confused with it.", "questions": [ { "id": "distinguishing-features-q01", "text": "What identifies and describes what distinguishes a harmonica, 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 harmonica, 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 harmonica 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 harmonica 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 harmonica, 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 harmonica, 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 harmonica 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 harmonica is built from and which parts are replaceable.", "questions": [ { "id": "parts-and-materials-q01", "text": "What identifies and describes the composition of a harmonica, 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 harmonica, 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 harmonica 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 harmonica is judged and by whom.", "questions": [ { "id": "condition-assessment-q01", "text": "What identifies and describes the condition of a harmonica, 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 harmonica, 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 harmonica 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 harmonica 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 harmonica is, and what that position is measured against.", "questions": [ { "id": "position-and-frame-q01", "text": "What identifies and describes the location of a harmonica, 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 harmonica, 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 harmonica 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 harmonica 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 harmonica, 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 harmonica, 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 harmonica 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 harmonica 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 harmonica between them.", "questions": [ { "id": "stages-and-transitions-q01", "text": "What identifies and describes the lifecycle of a harmonica, 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 harmonica, 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 harmonica 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 harmonica, how often and by whom.", "findings": [ { "id": "observation-record", "name": "Observation record", "description": "How an observation of a harmonica 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 harmonica, 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 harmonica, 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 harmonica 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 harmonica 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 harmonica 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 harmonica, 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 harmonica 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 harmonica 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 harmonica 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 harmonica 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 harmonica 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 harmonica, 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 harmonica 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 harmonica and how confident it is.", "questions": [ { "id": "claim-provenance-q01", "text": "What identifies and describes a claim about a harmonica, 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 harmonica, 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 harmonica 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 harmonica is retired without being erased.", "questions": [ { "id": "validity-and-supersession-q01", "text": "What identifies and describes the validity of a claim about a harmonica, 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 harmonica, 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 harmonica 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 } } } }