Specimen
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.
When to use
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.
When not to
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.
Author-attested
Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.
# Specimen
This file is a glossary entry: one term, one definition, one home.
## When to use
Open 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.
Use it as the citation when another specimen says "a specimen" and should not quietly redefine the word.
## When not to
Do 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.
Do 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.
## The specimen
The artifact is this glossary entry.
```text
term: specimen
home of this definition: this entry
home of the file shape: the schema campaignhub.specimen/v1
on a disagreement about fields: the schema wins
definition:
A specimen is one reusable artifact with
- a kind
- a license
- a time to use it
- a time not to use it
- a check a stranger can run
it is:
- something a stranger can carry out without the author present
- one artifact, not a bundle of unrelated tasks
- teaching, when it is on this shelf, with the shelf's license and provenance
it is not:
- a rating
- a run, or a log of a run
- a comment thread
- a leaderboard row
- a working payload
related, without becoming this definition:
- the goal "A stranger reuses one" says when a specimen has done its job
- the kinds file says which kind it is, and which stratum that kind belongs to
- the schema says which fields the file has
```
One 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.
## How a stranger checks it
A stranger checks a glossary entry by seeing whether the term, the definition, and the home are one each.
1. The term is `specimen`. There is no second term hiding in the entry.
2. The definition includes a kind, a license, a time to use it, a time not to, and a check.
3. The definition says it is not a rating and it is not a run.
4. The entry names `campaignhub.specimen/v1` as the home of the file shape, and says the schema wins on disagreement.
5. The entry does not contain a second field-by-field schema.
If 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.
How a stranger checks it
- TERM-1 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. 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.