{"slug":"cold-reader","title":"For a cold reader","description":"A handoff a cold reader can continue from: current state, decisions already made, the next action, and what not to retry. It assumes no memory of the author.","body":"# For a cold reader\n\nThis file is a handoff: what a cold reader needs in order to continue without the author.\n\n## When to use\n\nUse this form at the moment work changes hands. The next reader was not present for the thinking. They may be the apex picking up a worker's output, or a stranger continuing a public specimen.\n\nWrite what they need, and stop. They do not share your memory.\n\n## When not to\n\nDo not use this form as a diary, a chat log, or a justification of the path you took. The reader needs state, decisions, the next action, and the traps.\n\nDo not assume they can see your files, your earlier turns, or your intentions. If a fact matters, it is in the handoff. If a decision is still open, say it is open. Do not call it decided.\n\n## The specimen\n\nThe artifact is this handoff. The scene is public and generic: one specimen file is ready to be checked. No private sitting is required to understand it.\n\n```text\nto: the cold reader\nauthor_memory_assumed: none\nside_channel: none\n\nstate:\n  - One specimen file is written.\n  - The shelf check has not been run in this handoff.\n  - The specimen is not published.\n\ndecisions_already_made:\n  - Slug, title, and kind stay on the roster row.\n  - The license is CC-BY-4.0.\n  - The provenance sentence is the shelf's fixed sentence.\n  - The body is original teaching prose, not a private transcript.\n\nstill_open:\n  - Whether the shelf check exits 0.\n\nnext_action:\n  - Run the shelf check against the specimen directory.\n  - If it prints a failure, repair the specimen it names, and run the check again.\n  - Stop when it exits 0, or when a failure cannot be repaired without a private source. In that second case, escalate. Do not invent the source.\n\ndo_not_retry:\n  - Do not add a specimen the roster does not name.\n  - Do not treat a file that says complete as a passed check.\n  - Do not publish. Publishing is a person's gate.\n  - Do not widen the bead to touch the seed files.\n\nwhere_to_look:\n  - the specimen file named in the check's output\n  - the roster row for that slug\n```\n\nA cold reader who follows `next_action` and respects `do_not_retry` can continue. A reader who needs a sentence that is not here is holding a broken handoff, and the repair is to write the missing sentence into the form, not to phone the author.\n\n## How a stranger checks it\n\nThe check for a handoff is whether a cold reader can act.\n\n1. Give the fenced block, alone, to a person who has not read the rest of this page.\n2. Ask two questions: what is the single next action, and what is one thing they must not retry?\n3. The pass is: they answer \"run the shelf check\" and they name one item from `do_not_retry`, without asking you anything.\n4. The fail is: they need to ask what \"done\" means, where the file is, or whether they may publish.\n\nAlso scan the block for \"as we discussed,\" \"you remember,\" or a reference only the author could resolve. Any of those fails the copy. `author_memory_assumed` stays `none`.\n","kind":"handoff","stratum":"structure","license":"CC-BY-4.0","shot":"na","tags":["handoff","continuity","reader","state"],"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 handoff when work passes to someone who was not in the room, including a later you, and they must continue without asking the author.","avoid_when":"Do not write 'as we discussed' or leave the next action implicit. Do not use this form to smuggle a private transcript. The reader has no memory and no side channel.","eval_checks":[{"id":"HAND-1","text":"The handoff states current state, decisions already made, one next action, and what not to retry, with no author memory assumed.","how_checked":"Hand the fenced block to a reader who has not seen this page's framing. They can say the next action and one thing not to retry without asking a question."}],"published_at":"2026-09-24T21:59:21.000Z","updated_at":"2026-09-24T21:59:21.000Z","sensor":null,"edges":[{"from":"cold-reader","to":"apex","kind":"cites","title":"Apex"}]}