{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.coffee","code":"thing-q8486","url":"https://ver.cy/models/thing/q8486/","name":"coffee","alternateNames":["instant coffee","Cafelatory","stick coffee","instant coffee mix","powdered instant coffee","Frisco Coffee","Sanka","canned coffee","salt coffee","Half Million","specialty coffee","Coffee in Azerbaijan"],"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.MAT"],"industry":[],"navPath":"","tags":[],"facets":{}},"whatItIs":"A beverage brewed from roasted coffee beans, the seeds of Coffea plants, mainly arabica and robusta, prepared as espresso, filter, instant and many cultural styles; it contains caffeine and is a major traded commodity.","purpose":"Let an agent handle coffee by origin, variety, preparation, caffeine content, sustainability and culture, without personal medical advice.","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["Brewed from roasted seeds","Contains caffeine","Global commodity","Rich cultural traditions"],"structure":{"bundles":[{"id":"product","name":"Product","description":"Which coffee.","layers":[{"id":"origin","name":"Origin","description":"Beans.","findings":[{"id":"origin-finding","name":"Origin","description":"Origin and variety.","questions":[{"text":"Which origin, species and roast is it?","kind":"provenance"},{"text":"How is it processed?","kind":"definition"}]}]},{"id":"preparation","name":"Preparation","description":"Brewing.","findings":[{"id":"preparation-finding","name":"Preparation","description":"Preparation.","questions":[{"text":"How is this style prepared?","kind":"action"},{"text":"What ratio and grind are typical?","kind":"measurement"}]}]}]},{"id":"health","name":"Health","description":"Caffeine.","layers":[{"id":"guidance","name":"Guidance","description":"Caffeine limits.","findings":[{"id":"guidance-finding","name":"Guidance","description":"Caffeine guidance.","questions":[{"text":"What do health authorities say about caffeine intake, including in pregnancy?","kind":"provenance"},{"text":"How much caffeine is in this drink?","kind":"measurement"}]}]},{"id":"advice","name":"Advice","description":"Personal health.","findings":[{"id":"advice-finding","name":"Advice","description":"Advice limit.","questions":[{"text":"Is the user asking about caffeine and their own condition or medicines?","kind":"boundary"},{"text":"How should they be referred to a clinician or pharmacist?","kind":"action"}]}]}]},{"id":"sustainability","name":"Sustainability","description":"Supply chain.","layers":[{"id":"certification","name":"Certification","description":"Labels.","findings":[{"id":"certification-finding","name":"Certification","description":"Certifications.","questions":[{"text":"What does this certification label guarantee?","kind":"provenance"},{"text":"How is it audited?","kind":"provenance"}]}]},{"id":"farmers","name":"Farmers","description":"Livelihoods.","findings":[{"id":"farmers-finding","name":"Farmers","description":"Producer livelihoods.","questions":[{"text":"What do reliable sources say about coffee farmer incomes?","kind":"provenance"},{"text":"How can buyers support fair trade?","kind":"action"}]}]}]},{"id":"culture","name":"Culture","description":"Traditions.","layers":[{"id":"traditions","name":"Traditions","description":"Ceremonies.","findings":[{"id":"traditions-finding","name":"Traditions","description":"Coffee traditions.","questions":[{"text":"What coffee traditions exist in this culture, according to sources?","kind":"provenance"},{"text":"Are they described respectfully?","kind":"boundary"}]}]},{"id":"history","name":"History","description":"Spread.","findings":[{"id":"history-finding","name":"History","description":"History.","questions":[{"text":"How did coffee spread globally, according to historians?","kind":"provenance"},{"text":"Which sources are reliable?","kind":"provenance"}]}]}]}]},"agentConduct":{"may":["Prepare and serve coffee following hygiene rules and the drinker's stated preferences.","Report origin and certification claims from the supplier's documents."],"mustNot":["Serve caffeinated coffee to someone who asked for decaffeinated, or hide its caffeine content.","Serve drinks hot enough to scald without warning, especially to children.","Make origin, fair-trade or organic claims that the supply chain cannot support.","Encourage excessive caffeine use by children or pregnant people."],"requiresHuman":["Buying coffee on someone's behalf from a new supplier."]},"ethics":{"considerations":["Coffee farmers often earn little of the final price.","Caffeine affects health, sleep and some medical conditions."],"affectedParties":["Coffee farmers and workers","Drinkers sensitive to caffeine","Children"]},"owners":{"steward":"The person or business that holds it; food authorities regulate its sale.","roles":[],"masterSystems":[]},"relations":[{"target":"Q1365365","type":"parent","note":"registry parent class"},{"target":"Q2647467","type":"parent","note":"registry parent class"},{"target":"Q37756327","type":"parent","note":"registry parent class"},{"target":"Q742487","type":"parent","note":"registry parent class"},{"target":"non-alcoholic beverage and stimulant foodstuff","type":"related","note":"category"},{"target":"coffee bean","type":"related","note":"raw material"},{"target":"caffeine","type":"contains","note":"constituent"},{"target":"commodity","type":"related","note":"market"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.coffee","Wikidata: Q8486 (https://www.wikidata.org/wiki/Q8486)"]},"properties":{"applicability":"required","items":["caffeine per cup: about 60-150 mg - varies widely"]},"recognition":{"applicability":"required","items":["Arabica and robusta beans","Espresso, filter, instant","Coffee substitutes such as chicory are different","Dark brown beverage; roasted beans; ground or instant powder."]},"capabilities":{"applicability":"required","items":["compare coffee types and preparations","find caffeine guidance from health authorities","check sustainability certifications","learn about coffee cultures"]},"hazards":{"applicability":"required","items":["Excess caffeine for some people","Burns from hot drinks","Agents giving personal medical advice"]},"interfaces":{"applicability":"required","items":["Food labelling rules","EU deforestation regulation for coffee supply chains","Fairtrade and other certifications"]},"context":{"applicability":"required","items":["A popular drink, social ritual and livelihood for producers.","espresso-based drinks","filter and pour-over coffee","instant coffee","traditional styles such as Turkish or Ethiopian coffee","decaffeinated coffee"]}},"sources":[{"title":"Wikidata item Q8486: coffee","url":"https://www.wikidata.org/wiki/Q8486","note":"identity and sense of the item"},{"title":"Wikipedia: Coffee","url":"https://en.wikipedia.org/wiki/Coffee","note":"general description of the item"}],"openQuestions":["Should coffee drinks be separate entries?","How should certifications be linked?","How should cultural styles be attributed?"],"resources":{"spec":"/models/things/publications/thing-q8486/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-q8486/spec.json"],"providers":["Claude"],"researchStatus":"unreviewed","generatedAt":"2026-09-11T11:20:24Z","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-06T19:52:02+00:00: completeness 1.00; sense: Wikidata description; 2 live sources; review by codex: pass"},"score":1.0}}