{"slug":"name-the-consumer","title":"Name the consumer","description":"A loop record that names the producer, the output, and the reader of that output in one place. A directory is storage, not a reader.","body":"# Name the consumer\n\nThis file is a loop: a producer whose output names the consumer that reads it.\n\n## When to use\n\nUse this when you define a loop: someone produces an output, and someone else reads it. Write both names next to the output. The loop is real when the reader is a role that can act on what they read.\n\nThis is the record to fill in before you create the directory, not after.\n\n## When not to\n\nDo not call a directory a consumer. A directory holds bytes. It does not read them, approve them, or reuse them.\n\nDo not leave the reader as \"whoever needs it.\" If you cannot name the reader, you do not have a loop yet. You have a drop box.\n\n## The specimen\n\nThe artifact is this loop record. The library's public path is two loops, written so each output sits beside its reader.\n\n```text\nrecord: name the consumer\nrule: the producer, the output, and the consumer are written in the same block\na directory is storage, not a consumer\n\nloop: intake\n  producer: the person who submits a specimen\n  output: one pending specimen\n  consumer: the person who moderates\n  consumer_does: reads the specimen and approves or refuses\n  storage: the pending queue\n  storage_is_not_the_consumer: true\n\nloop: shelf\n  producer: the person who publishes\n  output: one published specimen\n  consumer: the stranger who reuses it\n  consumer_does: reads the specimen and copies what they will reuse\n  storage: the public shelf\n  storage_is_not_the_consumer: true\n\nsensor\n  may_advise: the person who moderates\n  is_not_the_consumer_of_the_publish_loop: true\n  does_not_publish: true\n```\n\nThe intake loop's consumer is required by the publish gate: the person who moderates is the person who can publish, and they are not the clerk that stored the row. The shelf loop's consumer is the stranger from the goal \"A stranger reuses one.\" Naming the shelf folder as the consumer fails the rule in the first block.\n\n## How a stranger checks it\n\nA stranger checks a loop record, this one or a new one, with the same three questions.\n\n1. Is there a block where producer, output, and consumer appear together? If the consumer is in another file and this block only names a path, the record fails.\n2. Is the consumer a person or a role that reads and does something with what they read? \"The downloads folder\" fails. \"The stranger who reuses it\" passes.\n3. If a directory is named, is it marked as storage rather than as the consumer?\n\nApply those questions to both loops above. Both need a pass. A copy that keeps the shelf loop and drops the intake loop has described a publish with no reader of the pending row, and it fails.\n","kind":"loop","stratum":"structure","license":"CC-BY-4.0","shot":"na","tags":["loop","consumer","output","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 loop record when you are about to call a piece of work finished because the output landed in a directory. Name the reader in the same place as the output.","avoid_when":"Do not name a folder, a bucket, or a queue as the consumer. Do not split the output and the reader across two documents that can drift apart.","eval_checks":[{"id":"LOOP-1","text":"Each loop block names producer, output, and consumer together, and the consumer is a role that reads.","how_checked":"In each fenced loop block, find producer, output, and consumer. Confirm the consumer is a person or role, and that the directory is labeled as storage rather than as the consumer."}],"published_at":"2026-09-24T21:59:21.000Z","updated_at":"2026-09-24T21:59:21.000Z","sensor":null,"edges":[{"from":"one-specimen-campaign","to":"name-the-consumer","kind":"composes","title":"A campaign that ships one specimen"},{"from":"name-the-consumer","to":"human-publishes","kind":"requires","title":"A person publishes"}]}