{"slug":"specimen","title":"Specimen","description":"One term, one definition, one home. A specimen is a reusable artifact with a kind, a license, a time to use it, a time not to, and a check. It is not a rating and it is not a run.","body":"# Specimen\n\nThis file is a glossary entry: one term, one definition, one home.\n\n## When to use\n\nOpen this entry when the word \"specimen\" is being stretched. Someone wants to file a star rating, a log of a run, or a transcript, and they want the shelf to hold it. The entry says what the word means here, and where the shape of the file lives.\n\nUse it as the citation when another specimen says \"a specimen\" and should not quietly redefine the word.\n\n## When not to\n\nDo not use this entry as the checklist of JSON fields. That checklist is the schema. If this entry and the schema disagree about a field name, the schema wins, and this entry is stale.\n\nDo not use the word for a score, a comment, or an execution. Those can sit beside a library in some other product. They are not specimens in this one.\n\n## The specimen\n\nThe artifact is this glossary entry.\n\n```text\nterm: specimen\nhome of this definition: this entry\nhome of the file shape: the schema campaignhub.specimen/v1\non a disagreement about fields: the schema wins\n\ndefinition:\n  A specimen is one reusable artifact with\n  - a kind\n  - a license\n  - a time to use it\n  - a time not to use it\n  - a check a stranger can run\n\nit is:\n  - something a stranger can carry out without the author present\n  - one artifact, not a bundle of unrelated tasks\n  - teaching, when it is on this shelf, with the shelf's license and provenance\n\nit is not:\n  - a rating\n  - a run, or a log of a run\n  - a comment thread\n  - a leaderboard row\n  - a working payload\n\nrelated, without becoming this definition:\n  - the goal \"A stranger reuses one\" says when a specimen has done its job\n  - the kinds file says which kind it is, and which stratum that kind belongs to\n  - the schema says which fields the file has\n```\n\nOne term, one definition, one home. The home of the word is this entry. Other pages may say \"specimen\" and should mean this. They should not paste a rival definition. The home of the fields is the schema named above. This entry mentions the five parts a stranger needs in order to use the word. It does not restate the schema's types, patterns, and limits, because those are a different fact with a different home.\n\n## How a stranger checks it\n\nA stranger checks a glossary entry by seeing whether the term, the definition, and the home are one each.\n\n1. The term is `specimen`. There is no second term hiding in the entry.\n2. The definition includes a kind, a license, a time to use it, a time not to, and a check.\n3. The definition says it is not a rating and it is not a run.\n4. The entry names `campaignhub.specimen/v1` as the home of the file shape, and says the schema wins on disagreement.\n5. The entry does not contain a second field-by-field schema.\n\nIf a page elsewhere defines specimen as \"any file we store,\" that page fails this check, and the repair is to point the page at this entry rather than to edit this entry into vagueness.\n","kind":"glossary","stratum":"sense","license":"CC-BY-4.0","shot":"na","tags":["glossary","specimen","definition","artifact"],"author_name":"Campaign Hub","author_url":"https://campaignhub.fyi/about","source_url":null,"provenance":"Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.","maturity":"practiced","audience_role":"any","safety_class":"public_teaching","harness":["generic"],"use_when":"Use this entry when someone calls a rating, a run log, or a raw chat a specimen. Point them at the definition and at the schema that holds the shape.","avoid_when":"Do not use this glossary entry as a second schema. The field list has one home. Do not use the word specimen for a score or for an execution trace.","eval_checks":[{"id":"TERM-1","text":"The entry defines specimen as a reusable artifact with a kind, a license, when to use, when not to, and a check, and it names the schema as the home of the shape.","how_checked":"Read the fenced entry. Confirm those five parts are in the definition, that rating and run are excluded, and that campaignhub.specimen/v1 is named as the home of the fields."}],"published_at":"2026-09-24T21:59:21.000Z","updated_at":"2026-09-24T21:59:21.000Z","sensor":null,"edges":[{"from":"four-strata","to":"specimen","kind":"cites","title":"The four strata"},{"from":"how-to-file-a-specimen","to":"specimen","kind":"cites","title":"How to file a specimen"},{"from":"one-specimen-window","to":"specimen","kind":"cites","title":"One specimen in the window"},{"from":"one-value-one-source","to":"specimen","kind":"cites","title":"One value, one source"},{"from":"stranger-reuses-one","to":"specimen","kind":"cites","title":"A stranger reuses one"}]}