{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.harmonica","code":"thing-q51290","url":"https://ver.cy/models/thing/q51290/","name":"harmonica","alternateNames":["Biram","bajón","Richter-tuned harmonica","bass harmonica","chromatic harmonica","Tremolo harmonica","diatonic harmonica"],"kind":"thing","status":"published","version":"0.1.0-research.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 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.","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.","scope":{"in":["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":["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"],"boundaries":[]},"distinguishingFeatures":["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."],"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.","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?","id":"supported-harmonica-type-q01","kind":"definition"},{"text":"Does this object form a playable harmonica, or is it a component or a neighbouring free-reed instrument?","id":"supported-harmonica-type-q02","kind":"boundary"}]}]},{"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?","id":"marked-versus-fitted-configuration-q01","kind":"provenance"},{"text":"Have reed plates, covers, comb or tuning been changed so that external markings no longer describe the instrument?","id":"marked-versus-fitted-configuration-q02","kind":"provenance"}]}]}]},{"id":"note-layout-and-selection","name":"Note layout and selection","description":"Describes which pitches the harmonica offers and how the player selects them.","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?","id":"installed-note-map-q01","kind":"definition"},{"text":"Where does one playing position sound multiple reeds, and are their intended relationships unison, tremolo, octave or chordal?","id":"installed-note-map-q02","kind":"definition"}]}]},{"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?","id":"control-dependent-pitches-q01","kind":"measurement"},{"text":"Which requested notes or chords can this layout supply without relying on an unverified pitch-altering technique?","id":"control-dependent-pitches-q02","kind":"action"}]}]}]},{"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.","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?","id":"position-specific-response-q01","kind":"measurement"},{"text":"What repeat test or inspection can distinguish a reed fault from leakage, moisture or the player's technique?","id":"position-specific-response-q02","kind":"action"}]}]},{"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?","id":"tuning-and-altered-note-evidence-q01","kind":"measurement"},{"text":"Which bends, overblows or overdraws have been demonstrated on this instrument, at which positions and by what test?","id":"tuning-and-altered-note-evidence-q02","kind":"measurement"},{"text":"Are observed pitch offsets intentional features of its temperament or paired-reed tuning, or unresolved deviations?","id":"tuning-and-altered-note-evidence-q03","kind":"boundary"}]}]}]},{"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.","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?","id":"air-routing-integrity-q01","kind":"measurement"},{"text":"Are comb surfaces, reed-plate joints and any fitted valves intact and functioning under the test conditions?","id":"air-routing-integrity-q02","kind":"measurement"}]}]},{"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?","id":"mechanical-interference-q01","kind":"measurement"},{"text":"If a slide is fitted, does it travel and return reliably while selecting the expected air passages?","id":"mechanical-interference-q02","kind":"measurement"},{"text":"Which observed defects require withholding play until loose parts, sharp edges or mechanical damage are addressed?","id":"mechanical-interference-q03","kind":"action"}]}]}]},{"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.","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?","id":"supported-cleaning-method-q01","kind":"measurement"},{"text":"Which documented cleaning and drying methods apply to the fitted comb, reeds, valves, coatings and adhesives?","id":"supported-cleaning-method-q02","kind":"provenance"},{"text":"What cleaning action is supported by that evidence, and what unresolved material information prevents a method from being selected?","id":"supported-cleaning-method-q03","kind":"action"}]}]},{"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?","id":"verified-service-path-q01","kind":"action"},{"text":"After servicing, which affected notes, seals, controls and mouth-contact surfaces must be checked before returning the harmonica to play?","id":"verified-service-path-q02","kind":"action"}]}]}]},{"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.","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.","questions":[{"text":"Which of these kinds and varieties hold for the sense of harmonica this model covers, and on what evidence?","id":"evidence-kinds-q01","kind":"provenance"}]}]}]}]},"agentConduct":{"may":["Describe a harmonica's type, key and tuning.","Clean and adjust a harmonica the user owns, on the user's request.","Teach playing techniques and transcribe tunes the user has the right to use."],"mustNot":["Share a harmonica between players without cleaning it, given that it is played with the mouth.","Give a harmonica with loose small parts to a young child.","Misrepresent a harmonica's make or materials, such as hidden lead or nickel content.","Play or test loudly next to people in a way that harms their hearing."],"requiresHuman":["Lending or reselling a used harmonica to another player."]},"ethics":{"considerations":["An instrument played with the mouth raises hygiene and health questions when it is shared.","Cheap instruments for children must be safe as toys as well as instruments."],"affectedParties":["Players, especially children","People sharing instruments","Buyers"]},"owners":{"steward":"The person who owns and plays it.","roles":[],"masterSystems":[]},"relations":[{"target":"Q19650003","type":"parent","note":"registry parent class"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.harmonica","Wikidata: Q51290 (https://www.wikidata.org/wiki/Q51290)"]},"properties":{"applicability":"required","items":["Instrument family: diatonic; slide chromatic; tremolo; octave; bass; chord; other; unresolved","Mouthpiece hole arrangement: Hole count, row count and physical grouping","Installed pitch layout: Mouthpiece position × breath direction × control position → sounding pitch or pitches","Marked key and tuning designation: Observed inscription or documented designation; absent; unresolved","Pitch deviation: Cents from a stated target under recorded playing conditions","Reed response: Responsive; delayed; intermittent; silent; rattling; untested, by playable position","Air-path sealing: No problematic leakage observed; leakage suspected; leakage localised; untested","Wetted and mouth-contact materials: Observed or documented materials and coatings by component; unknown","Service-part compatibility: Instrument configuration → verified compatible reed plates, reeds, valves, slides and fasteners"]},"recognition":{"applicability":"required","items":["Small rectangular instrument held across the lips.","A row of square holes along one edge of the mouthpiece.","Metal cover plates over a comb of wood, plastic or metal; chromatic models have a side slide button."]},"capabilities":{"applicability":"required","items":["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."]},"hazards":{"applicability":"required","items":["Spread of infection through shared use.","Choking risk from small parts for young children.","Skin reactions to nickel or other metals in plates and covers."]},"interfaces":{"applicability":"required","items":["ISO 16, issued by the International Organization for Standardization, specifies a standard musical tuning frequency that can serve as a reference when tuning or checking a harmonica."]},"context":{"applicability":"required","items":["A harmonica is used for melody, accompaniment and expressive effects in solo and ensemble music.","It is encountered in music education, informal playing, recording and live performance across several musical traditions.","Instrument type, key and tuning influence its suitability for a particular piece or playing technique."]}},"sources":[{"title":"Wikidata item Q51290: harmonica","url":"https://www.wikidata.org/wiki/Q51290","note":"identity and sense of the item"},{"title":"Wikipedia: Harmonica","url":"https://en.wikipedia.org/wiki/Harmonica","note":"general description of the item"}],"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?"],"resources":{"spec":"/models/things/publications/thing-q51290/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-q51290/spec.json"],"providers":["Codex","Grok"],"researchStatus":"unreviewed","generatedAt":"2026-09-07T13:42:25Z","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:31+00:00: completeness 1.00; sense: Wikidata description; 2 live sources; review by codex: pass"},"score":1.0}}