{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.musical-instrument","code":"thing-q34379","url":"https://ver.cy/models/thing/q34379/","name":"musical instrument","alternateNames":[],"kind":"thing","status":"published","version":"0.2.0-wave.1","language":"en","classifiers":{"family":"Thing Registry","category":"Physical world and living systems","entryKind":"thing","plane":"PHY","domain":["PHY.OBJ"],"industry":[],"navPath":"","tags":[],"facets":{}},"whatItIs":"A device created or adapted to make musical sounds, classified in the Hornbostel-Sachs system as idiophones, membranophones, chordophones, aerophones and electrophones.","purpose":"Let an agent handle musical instruments by classification, construction, playing, care, hire and trade rules.","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["Designed to make musical sound","Classified by sound production","Crafted from wood, metal, skin or electronics","Needs regular care"],"structure":{"bundles":[{"id":"classification","name":"Classification","description":"Which instrument.","layers":[{"id":"class","name":"Class","description":"Hornbostel-Sachs.","findings":[{"id":"class-finding","name":"Class","description":"Instrument class.","questions":[{"text":"How does this instrument produce sound?","kind":"definition"},{"text":"What is its Hornbostel-Sachs class?","kind":"definition"}]}]},{"id":"maker","name":"Maker","description":"Origin.","findings":[{"id":"maker-finding","name":"Maker","description":"Maker and origin.","questions":[{"text":"Who made it and when?","kind":"provenance"},{"text":"Is a label or serial number present?","kind":"provenance"}]}]}]},{"id":"playing","name":"Playing","description":"Learning.","layers":[{"id":"choice","name":"Choice","description":"Size and type.","findings":[{"id":"choice-finding","name":"Choice","description":"Choosing an instrument.","questions":[{"text":"Which size or type suits this learner?","kind":"action"},{"text":"Is hiring before buying possible?","kind":"action"}]}]},{"id":"hearing","name":"Hearing","description":"Protection.","findings":[{"id":"hearing-finding","name":"Hearing","description":"Hearing protection.","questions":[{"text":"How loud is the instrument in practice?","kind":"measurement"},{"text":"Is musician hearing protection advisable?","kind":"action"}]}]}]},{"id":"care","name":"Care","description":"Maintenance.","layers":[{"id":"maintenance","name":"Maintenance","description":"Tuning and servicing.","findings":[{"id":"maintenance-finding","name":"Maintenance","description":"Maintenance.","questions":[{"text":"How often does it need tuning or servicing?","kind":"measurement"},{"text":"Who can service it?","kind":"action"}]}]},{"id":"environment","name":"Environment","description":"Humidity.","findings":[{"id":"environment-finding","name":"Environment","description":"Storage conditions.","questions":[{"text":"What humidity and temperature should it be kept in?","kind":"measurement"},{"text":"Is a case or humidifier needed?","kind":"action"}]}]}]},{"id":"rules","name":"Rules","description":"Travel and trade.","layers":[{"id":"cites","name":"CITES","description":"Protected materials.","findings":[{"id":"cites-finding","name":"CITES","description":"Protected materials.","questions":[{"text":"Does the instrument contain CITES-listed materials?","kind":"boundary"},{"text":"Is a musical instrument certificate needed for travel?","kind":"provenance"}]}]},{"id":"travel","name":"Travel","description":"Airlines.","findings":[{"id":"travel-finding","name":"Travel","description":"Air travel.","questions":[{"text":"Can it travel in the cabin on this airline?","kind":"provenance"},{"text":"How should it be packed?","kind":"action"}]}]}]}]},"agentConduct":{"may":["Describe instruments and their classification.","Help players with tuning, care and practice."],"mustNot":["Trade instruments made from protected species, such as ivory or rare woods, without permits.","Remove or damage instruments of cultural or sacred significance.","Misrepresent an instrument's maker, age or provenance."],"requiresHuman":["Selling or exporting a historic or culturally significant instrument."]},"ethics":{"considerations":["Some instruments are sacred to their communities.","Materials such as ivory and rare woods are protected by law."],"affectedParties":["Musicians","Communities with sacred instruments","Protected species"]},"owners":{"steward":"The person who keeps it; museums and communities hold heritage instruments.","roles":[],"masterSystems":["Wildlife trade permits under international trade conventions"]},"relations":[{"target":"Q267228","type":"parent","note":"registry parent class"},{"target":"Q39546","type":"parent","note":"registry parent class"},{"target":"Q56146933","type":"parent","note":"registry parent class"},{"target":"Q8205328","type":"parent","note":"registry parent class"},{"target":"sound generator","type":"related","note":"category"},{"target":"music","type":"related","note":"practice"},{"target":"Hornbostel-Sachs","type":"related","note":"system"},{"target":"luthier and instrument maker","type":"related","note":"craft"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.musical-instrument","Wikidata: Q34379 (https://www.wikidata.org/wiki/Q34379)","Hornbostel-Sachs number: hierarchical code classification"]},"properties":{"applicability":"required","items":["Overall dimensions:  mm - Measure the maximum length, width and height in the stated playing or storage configuration.","Instrument mass:  kg - Weigh the instrument and specify whether detachable accessories and supports are included.","Acoustic output level:  dB SPL - Measure sound pressure level at a stated distance with the playing conditions and frequency weighting recorded."]},"recognition":{"applicability":"required","items":["How the sound is produced decides the class","Maker labels and serial numbers","Toy instruments are a related category","Enormously varied: strings, tubes, drums, keys and electronic units."]},"capabilities":{"applicability":"required","items":["identify and classify instruments","choose an instrument and size for a learner","maintain and tune instruments","check travel and trade rules for protected materials"]},"hazards":{"applicability":"required","items":["Hearing damage from loud playing","Seizure of instruments with undocumented protected materials","Damage from humidity and temperature"]},"interfaces":{"applicability":"required","items":["CITES rules for rosewood, ivory and tortoiseshell","Airline cabin rules for instruments","Noise at work regulations for musicians"]},"context":{"applicability":"required","items":["Making music.","idiophones","membranophones","chordophones","aerophones","electrophones"]}},"sources":[{"title":"Wikidata item Q34379: musical instrument","url":"https://www.wikidata.org/wiki/Q34379","note":"identity and sense of the item"},{"title":"Wikipedia: Musical instrument","url":"https://en.wikipedia.org/wiki/Musical_instrument","note":"general description of the item"}],"openQuestions":["Should each instrument family be a separate entry?","How should Hornbostel-Sachs codes be linked?","How should CITES documentation be recorded?"],"resources":{"spec":"/models/things/publications/thing-q34379/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-q34379/spec.json"],"providers":["Claude"],"researchStatus":"unreviewed","generatedAt":"2026-09-11T09:30:48Z","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":"filled","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-07T10:10:30+00:00: completeness 1.00; sense: Wikidata description; 2 live sources; review by codex: pass"},"score":1.0}}