{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.specification","code":"thing-q2101564","url":"https://ver.cy/models/thing/q2101564/","name":"specification","alternateNames":["Java Specification Request","technical specification","open specification","sampling plan","record layout","Publicly Available Specification","product specification","functional specification","design specification","software requirements specification","system requirements","open license"],"kind":"thing","status":"published","version":"0.2.0-wave.4","language":"en","classifiers":{"family":"Thing Registry","category":"Information and virtual systems","entryKind":"thing","plane":"INF","domain":["INF.MED"],"industry":[],"navPath":"","tags":[],"facets":{}},"whatItIs":"A document that precisely states requirements, design, behaviour or characteristics that a product, material, process, service or data format must meet, used in engineering, software, procurement and standardisation, in forms such as technical specifications, open specifications freely available for implementation, Publicly Available Specifications published by BSI, Java Specification Requests in the Java Community Process and record layouts describing data file structures; the registry alias sampling plan is a quality control scheme that may be part of a specification but is a different document type.","purpose":"Let an agent explain specifications, relay kinds, structure and relationship to standards from standards bodies and engineering sources, describe the named specification types, and distinguish specifications from standards, requirements documents, contracts and sampling plans.","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["Precise requirements","Verifiable","Many domains","May be open or proprietary"],"structure":{"bundles":[{"id":"understand","name":"Understand","description":"What a specification is.","layers":[{"id":"definition","name":"Definition","description":"Definition.","findings":[{"id":"definition-finding","name":"Definition","description":"Definition.","questions":[{"text":"What is a specification, and how does it differ from standards, requirements documents, contracts and sampling plans?","kind":"definition"},{"text":"Is the question about software, engineering, procurement or standards?","kind":"boundary"}]}]},{"id":"types","name":"Types","description":"Named types.","findings":[{"id":"types-finding","name":"Types","description":"Types.","questions":[{"text":"What are JSRs, technical specifications, open specifications, record layouts and PAS documents, and why is a sampling plan different?","kind":"definition"},{"text":"Which entry fits the specific type?","kind":"action"}]}]}]},{"id":"writing","name":"Writing","description":"Writing specifications.","layers":[{"id":"language","name":"Language","description":"Requirement language.","findings":[{"id":"language-finding","name":"Language","description":"Language.","questions":[{"text":"How do keywords such as MUST and SHOULD make requirements testable?","kind":"provenance"},{"text":"Which references are standard?","kind":"provenance"}]}]},{"id":"structure","name":"Structure","description":"Structure.","findings":[{"id":"structure-finding","name":"Structure","description":"Structure.","questions":[{"text":"What sections do specifications typically contain?","kind":"provenance"},{"text":"Which sources are cited?","kind":"provenance"}]}]}]},{"id":"standards","name":"Standards","description":"Standards processes.","layers":[{"id":"iso","name":"ISO","description":"ISO document types.","findings":[{"id":"iso-finding","name":"ISO","description":"ISO.","questions":[{"text":"How do ISO technical specifications differ from International Standards?","kind":"provenance"},{"text":"Which entry fits International Organization for Standardization?","kind":"action"}]}]},{"id":"open","name":"Open","description":"Open specifications.","findings":[{"id":"open-finding","name":"Open","description":"Open.","questions":[{"text":"What makes a specification open, and how are community processes like the JCP run?","kind":"provenance"},{"text":"Which entry fits open standard?","kind":"action"}]}]}]},{"id":"context","name":"Context","description":"Uses.","layers":[{"id":"procurement","name":"Procurement","description":"Procurement.","findings":[{"id":"procurement-finding","name":"Procurement","description":"Procurement.","questions":[{"text":"How are specifications used in public procurement?","kind":"provenance"},{"text":"Which entry fits public procurement?","kind":"action"}]}]},{"id":"data","name":"Data","description":"Data layouts.","findings":[{"id":"data-finding","name":"Data","description":"Data.","questions":[{"text":"How do record layouts describe fixed-width data files?","kind":"provenance"},{"text":"Which entry fits file format?","kind":"action"}]}]}]}]},"agentConduct":{"may":["Check a design, product or dataset against a specification and report any gaps.","Cite a specification by its title, version and issuer."],"mustNot":["Claim that something meets a specification without testing it.","Change a shared specification without its owner's approval.","Present a private specification as an official standard.","Copy or circulate a confidential specification beyond its audience."],"requiresHuman":["Accepting deviations from a specification in safety-relevant work."]},"ethics":{"considerations":["Ambiguous specifications shift risk onto the people who build and use the product.","Specifications can be written to favour one supplier in public procurement."],"affectedParties":["Users of the product","Suppliers and bidders","Engineers"]},"owners":{"steward":"The author or issuing organization of the specification.","roles":[],"masterSystems":[]},"relations":[{"target":"Q49848","type":"parent","note":"registry parent class"},{"target":"document","type":"related","note":"in registry terms"},{"target":"technical standard","type":"related"},{"target":"Java Specification Request","type":"related"},{"target":"acceptance sampling","type":"related","note":"misfiled alias sampling plan"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.specification","Wikidata: Q2101564 (https://www.wikidata.org/wiki/Q2101564)"]},"properties":{"applicability":"not-applicable","items":["ISO/IEC Directives document types: IS, TS, PAS, TR list","Java Community Process: 1998 year","RFC 2119 keywords: MUST, SHOULD, MAY note"]},"recognition":{"applicability":"optional","items":["Document stating precise requirements","Java Specification Request, technical specification, open specification, sampling plan, record layout, Publicly Available Specification","Standards are consensus documents from recognised bodies; requirements documents may be informal; contracts create obligations; sampling plans guide inspection","Not a visible object; structured documents with numbered requirements."]},"capabilities":{"applicability":"required","items":["explain kinds and structure","relay relationship to standards","describe named specification types","distinguish related documents"]},"hazards":{"applicability":"required","items":["Ambiguous requirements","Confusing specifications with standards","Registry alias for a sampling plan"]},"interfaces":{"applicability":"required","items":["ISO/IEC Directives","RFC 2119 and RFC 8174","Public procurement rules on technical specifications"]},"context":{"applicability":"required","items":["Defining what something must be or do.","technical specifications","open specifications","publicly available specifications","software and API specifications","data format and record layout specifications","procurement specifications"]}},"sources":[{"title":"Wikidata item Q2101564: specification","url":"https://www.wikidata.org/wiki/Q2101564","note":"identity and sense of the item"},{"title":"Wikipedia: Specification (technical standard)","url":"https://en.wikipedia.org/wiki/Specification_%28technical_standard%29","note":"general description of the item"}],"openQuestions":["Should PAS and JSR be separate entries?","How should standards bodies be linked?","The registry alias sampling plan should be moved to acceptance sampling"],"resources":{"spec":"/models/things/publications/thing-q2101564/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-q2101564/spec.json"],"providers":["Claude"],"researchStatus":"unreviewed","generatedAt":"2026-09-13T20:31:57Z","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:56+00:00: completeness 1.00; sense: Wikidata description; 2 live sources; review by codex: pass","interaction.properties":"Plane INF: no invented physical properties."},"score":1.0}}