{"slug":"markdown-carrier","title":"Markdown carrier","description":"How to carry any specimen as one markdown file: short front matter for the fields, then the body. The carrier adds no runtime, server, or package.","body":"# Markdown carrier\n\nThis file is an adapter: one markdown carrier, fields in front matter, prose in the body, no runtime.\n\n## When to use\n\nUse this adapter when you need to carry a specimen onto a harness that can read a markdown file, or into a form that a person fills by hand. The file holds the fields in a short front matter block and the teaching in the body under it.\n\nOne specimen, one file. A stranger can open it in any text editor.\n\n## When not to\n\nDo not turn the carrier into a project. No package file, no server, no runner that \"executes the specimen.\" The library does not execute specimens, and this adapter does not sneak execution in through a build step.\n\nDo not use the carrier to store a second, drifted copy of the roster. The front matter of a real filing still takes slug, title, and kind from the roster row.\n\n## The specimen\n\nThe artifact is this file shape. The example is a toy rule so the shape is visible. It is not a roster row.\n\n```markdown\n---\nschema: campaignhub.specimen/v1\nslug: example-standing-rule\ntitle: Example standing rule\nkind: rule\nlicense: CC-BY-4.0\nmaturity: practiced\naudience_role: any\nsafety_class: public_teaching\nshot: na\nharness:\n  - generic\ntags:\n  - example\n  - rule\nuse_when: Use the rule inside when a claim of done needs an observation.\navoid_when: Do not quote the rule in place of running the check.\nprovenance: Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.\n---\n\n# Example standing rule\n\n## When to use\n\nUse the rule when a model is about to claim the work is done.\n\n## When not to\n\nLeave the rule unused when no claim is being made.\n\n## The specimen\n\nRule: a claim of done points at an observation a stranger can rerun.\n\n## How a stranger checks it\n\nAsk for a claim with no observation attached. The rule requires the words \"not verified.\"\n```\n\nFront matter is the fields. The body is the specimen a person reads. The carrier adds no command to run, no port to bind, and no dependency to install. To submit, a person copies the fields into the form and the body into the body field. The workflow that receives them is \"Submit, moderate, read.\" This adapter binds that path to a file. It does not become a fourth step.\n\n## How a stranger checks it\n\nA stranger checks the carrier by inspection.\n\n1. The example is one fenced file, not a directory.\n2. The file begins with a line that is exactly `---`, a block of `key: value` lines, and a closing `---`.\n3. The body after the closing marker contains the specimen's prose, including when to use it and when not to.\n4. Search the file for an install command, a server entrypoint, a port, or a runner. None of those belong. Finding one fails the copy.\n5. The slug in the example is `example-standing-rule`. It is a shape demo. A real filing replaces that slug with a roster slug and does not add the example to the roster.\n\nA carrier that needs a program to be \"opened\" is not this adapter.\n","kind":"adapter","stratum":"structure","license":"CC-BY-4.0","shot":"na","tags":["adapter","markdown","front-matter","carrier"],"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 carrier when a specimen needs to move as one file that a person can read, diff, and paste into the submit form, without installing a runner.","avoid_when":"Do not add a runtime, a package manifest, or a server to the carrier. Do not split one specimen across several files and still call it this adapter.","eval_checks":[{"id":"CARRY-1","text":"The carrier is one markdown file with front matter and a body, and it names no runtime, server, or package install.","how_checked":"Open the fenced file. Confirm it starts with front matter between --- lines, the body follows, and the file contains no install command, port, or server entrypoint."}],"published_at":"2026-09-24T21:59:21.000Z","updated_at":"2026-09-24T21:59:21.000Z","sensor":null,"edges":[{"from":"markdown-carrier","to":"submit-moderate-read","kind":"binds","title":"Submit, moderate, read"}]}