{"slug":"one-specimen-campaign","title":"A campaign that ships one specimen","description":"A one-page campaign whose product is a single specimen. It has one phase, one bead, a human publish gate, and a named reader.","body":"# A campaign that ships one specimen\n\nThis file is a campaign: phases, a bead, a gate, and a named reader, on one page.\n\n## When to use\n\nUse this page when the thing you are shipping is one specimen and you want the whole campaign visible at once. A reader should see the phase, the bead, the gate, and the person who consumes the result, without hunting through a stack of notes.\n\nIt is the smallest campaign that still has those parts.\n\n## When not to\n\nDo not use this page for a campaign that ships several products. Add beads only by writing a new campaign page. Do not quietly add a second deliverable under the same bead.\n\nDo not remove the gate because the specimen \"looks small.\" Small specimens still wait for a person before they are published. Do not name the output folder as the reader.\n\n## The specimen\n\nThe artifact is this campaign. It is one page.\n\n```text\nCampaign: Ship one specimen\nproduct: one specimen a stranger can reuse without the author present\nreader: the stranger who reuses that specimen\nreader_is_not: the directory that stores the file\n\nphase: file\n  purpose: produce the specimen and hold it until a person publishes\n\n  bead:\n    deliverable: one specimen file\n    how_checked: the bead check exits 0 on that file, and a stranger can point at the specimen's own check\n    may_change: the one specimen file\n    must_not_touch: the roster, the seed, and every other specimen\n\n  gate: a person publishes\n    closed_while: the specimen is pending and no person has approved it\n    opens_when: a person approves\n    sensor: may advise the person before the decision\n    sensor_does_not: open the gate, publish, or change the kind\n\n  consumer:\n    output: the published specimen\n    reader: the stranger named above\n    same_place: the output and the reader are named in this block\n\nstop: the stranger can reuse the specimen, or a person has refused it\nicing: do not execute the specimen, and do not let a sensor publish\nfuel_out: do not apply a half-finished schema change with no previous release to return to\n```\n\nThe bead inside this page uses the four-field envelope. The gate is the specimen \"A person publishes.\" The consumer block is the specimen \"Name the consumer.\" This page composes them. It does not rewrite their rules. If this page and those specimens disagree, those specimens win on their own subjects, and this page should be edited to point at them again.\n\n## How a stranger checks it\n\nA stranger checks the page by finding four names.\n\n1. The phase is named, and there is one phase.\n2. The bead has `deliverable`, `how_checked`, `may_change`, and `must_not_touch`, each with a value.\n3. The gate opens when a person approves, and the sensor is forbidden to open it.\n4. The reader is a role, the stranger who reuses the specimen. If the only reader named is a folder, a bucket, or \"the files,\" the campaign fails.\n\nThe page also fails if a second product appears, or if the stop condition is only \"the file exists.\" Existence of the specimen file is not the campaign's finish line. The stranger's reuse is.\n","kind":"campaign","stratum":"structure","license":"CC-BY-4.0","shot":"na","tags":["campaign","specimen","gate","reader"],"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":"apex","safety_class":"public_teaching","harness":["generic"],"use_when":"Use this campaign when the product is one specimen and you need the phase, the bead, the publish gate, and the reader on a single page.","avoid_when":"Do not stretch this page into a multi-product program. Do not drop the human gate, and do not name a directory as the reader of the result.","eval_checks":[{"id":"CAMP-1","text":"The page names one phase, one bead with the four fields, a human publish gate, and a reader who is a role rather than a directory.","how_checked":"Read the fenced campaign. Confirm phase, bead, gate, and reader are all present, the gate opens only on a person's approve, and the reader is the stranger who reuses the specimen."}],"published_at":"2026-09-24T21:59:21.000Z","updated_at":"2026-09-24T21:59:21.000Z","sensor":null,"edges":[{"from":"four-node-campaign","to":"one-specimen-campaign","kind":"cites","title":"Four nodes"},{"from":"one-specimen-campaign","to":"four-field-envelope","kind":"composes","title":"The four-field envelope"},{"from":"one-specimen-campaign","to":"human-publishes","kind":"composes","title":"A person publishes"},{"from":"one-specimen-campaign","to":"name-the-consumer","kind":"composes","title":"Name the consumer"},{"from":"icing-and-fuel-out","to":"one-specimen-campaign","kind":"guards","title":"Icing and fuel-out"}]}