{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.week","code":"thing-q23387","url":"https://ver.cy/models/thing/q23387/","name":"week","alternateNames":["thematic week","intercalary week","international week","last full week of October","19th-26th September","this week","next week","week after the next","week 32","week 33","week 34","week 35"],"kind":"thing","status":"published","version":"0.2.0-wave.1","language":"en","classifiers":{"family":"Thing Registry","category":"Cross-cutting context","entryKind":"thing","plane":"XCT","domain":["XCT.TME"],"industry":[],"navPath":"","tags":[],"facets":{}},"whatItIs":"A period of seven consecutive days, used as a cycle for work, rest and scheduling, with numbering conventions such as ISO 8601 weeks.","purpose":"Let an agent handle weeks with their start day and numbering convention, and resolve relative expressions such as this week and next week.","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["Seven days, not tied to astronomy","Start day differs: Monday in ISO 8601, Sunday in some countries","Week numbering differs between conventions","Themed weeks and intercalary weeks are special uses"],"structure":{"bundles":[{"id":"convention","name":"Convention","description":"Start day and numbering.","layers":[{"id":"start","name":"Start day","description":"Monday or Sunday.","findings":[{"id":"start-finding","name":"Start day","description":"The first day of the week.","questions":[{"text":"Which day starts the week here?","kind":"definition"},{"text":"Does the context use ISO 8601?","kind":"provenance"}]}]},{"id":"numbering","name":"Numbering","description":"ISO or local week numbers.","findings":[{"id":"numbering-finding","name":"Week number","description":"The numbering scheme.","questions":[{"text":"Which week number is this, under which scheme?","kind":"measurement"},{"text":"Does the year have 53 weeks?","kind":"boundary"}]}]}]},{"id":"relative","name":"Relative references","description":"This week, next week.","layers":[{"id":"reference","name":"Reference date","description":"Anchor.","findings":[{"id":"reference-finding","name":"Anchor","description":"The date relative expressions refer to.","questions":[{"text":"Relative to which date is next week meant?","kind":"definition"},{"text":"In which time zone?","kind":"boundary"}]}]},{"id":"resolution","name":"Resolution","description":"Mapping to dates.","findings":[{"id":"resolution-finding","name":"Resolved range","description":"The dates covered.","questions":[{"text":"Which exact dates does this expression cover?","kind":"measurement"},{"text":"How should ambiguity be confirmed with the user?","kind":"action"}]}]}]},{"id":"work-and-law","name":"Work and law","description":"Working weeks.","layers":[{"id":"working","name":"Working week","description":"Days and hours.","findings":[{"id":"working-finding","name":"Working week","description":"Working days and hours.","questions":[{"text":"Which days are working days here?","kind":"definition"},{"text":"What maximum weekly hours apply?","kind":"boundary"}]}]},{"id":"holidays","name":"Holidays","description":"Public holidays in the week.","findings":[{"id":"holidays-finding","name":"Holidays","description":"Holidays affecting the week.","questions":[{"text":"Which public holidays fall in this week?","kind":"provenance"},{"text":"How do they affect deadlines?","kind":"boundary"}]}]}]},{"id":"designated","name":"Designated weeks","description":"Themed and special weeks.","layers":[{"id":"themed","name":"Themed weeks","description":"Awareness and events.","findings":[{"id":"themed-finding","name":"Designation","description":"Who designated the week.","questions":[{"text":"Who designated this week, and for what?","kind":"provenance"},{"text":"Do its dates change each year?","kind":"boundary"}]}]},{"id":"calendar","name":"Calendar systems","description":"Intercalary weeks.","findings":[{"id":"calendar-finding","name":"Calendar","description":"Special weeks in calendars.","questions":[{"text":"Does the calendar insert an extra week?","kind":"definition"},{"text":"How is it numbered?","kind":"definition"}]}]}]}]},"agentConduct":{"may":["Calculate week numbers and dates, stating the convention and the first day of the week.","Resolve relative expressions such as next week with the user before acting on them."],"mustNot":["Assume a week start day without checking the locale or convention.","Mishandle week 53 or weeks crossing a year boundary.","Act on an ambiguous relative week expression in a commitment."],"requiresHuman":["Scheduling commitments for others based on an ambiguous week."]},"ethics":{"considerations":["Working weeks and rest days embody hard-won rights and religious observance."],"affectedParties":["Workers","People who keep a weekly day of rest"]},"owners":{"steward":"Nobody owns the week; standards bodies define week numbering.","roles":[],"masterSystems":[]},"relations":[{"target":"Q186081","type":"parent","note":"registry parent class"},{"target":"Q29441572","type":"parent","note":"registry parent class"},{"target":"day","type":"related","note":"seven days"},{"target":"year","type":"related","note":"weeks in a year"},{"target":"time","type":"related","note":"a unit of time"},{"target":"working week","type":"related","note":"fewer days"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.week","Wikidata: Q23387 (https://www.wikidata.org/wiki/Q23387)","ISO week date: YYYY-Www-D ISO 8601 week date"]},"properties":{"applicability":"not-applicable","items":["length: 7 days","ISO weeks per year: 52 or 53 weeks"]},"recognition":{"applicability":"optional","items":["Calendar rows of seven days","Week numbers such as 2026-W37","Phrases such as this week or next week, which depend on the reference date","Not visible; shown as rows in calendars and week numbers."]},"capabilities":{"applicability":"required","items":["number it, under ISO 8601 or local conventions","schedule by it","resolve relative references, such as next week","designate themed weeks, such as an awareness week"]},"hazards":{"applicability":"required","items":["Different week start days causing off-by-one errors","Week 53 and year-boundary errors","Ambiguous relative expressions"]},"interfaces":{"applicability":"required","items":["ISO 8601 week dates","Working time law defining working weeks"]},"context":{"applicability":"required","items":["Organising work, rest, schedules and reporting in a seven-day cycle.","calendar week","ISO week","working week","themed or international weeks","intercalary weeks in some calendars"]}},"sources":[{"title":"Wikidata item Q23387: week","url":"https://www.wikidata.org/wiki/Q23387","note":"identity and sense of the item"},{"title":"Wikipedia: Week","url":"https://en.wikipedia.org/wiki/Week","note":"general description of the item"}],"openQuestions":["Should the working week be a separate entry?","How should relative week expressions be resolved and recorded?","The registry entry has merged aliases naming specific weeks; should they be split off?"],"resources":{"spec":"/models/things/publications/thing-q23387/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-q23387/spec.json"],"providers":["Claude"],"researchStatus":"unreviewed","generatedAt":"2026-09-11T05:00:00Z","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":"not-applicable","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:51:57+00:00: completeness 1.00; sense: Wikidata description; 2 live sources; review by codex: pass","interaction.properties":"Plane XCT: no invented physical properties."},"score":1.0}}