{"slug":"empty-shelf","title":"An empty shelf teaches the form","description":"A retrospective of a registry that shipped a submission form and no specimens. People learned how to submit. They learned nothing about the craft. A library starts by putting specimens on the shelf.","body":"# An empty shelf teaches the form\n\nThis file is a retrospective: what a finished effort taught, kept separate from the plan that started it.\n\n## When to use\n\nRead this when you are planning a library, a catalog, or a registry of agent artifacts, and the first release is about to be the submission form alone. The retrospective is here so you can see that choice after it has already been tried, with the lesson separated from the plan that sounded reasonable.\n\nIt is a teaching retrospective. It does not depend on a private postmortem.\n\n## When not to\n\nDo not read this as a requirement to skip the form. The form was necessary. It was not sufficient.\n\nDo not read it as a claim that any specimen will do. A shelf of unlabeled blobs teaches as little as an empty shelf. The lesson is narrower: the craft becomes visible when a stranger can open a specimen and reuse it.\n\n## The specimen\n\nThe artifact is this retrospective.\n\n```text\nRetrospective: an empty shelf\n\nWhat shipped\nA public registry with a submission form, a small set of type labels, and a review queue.\nThe public shelf had no published specimens.\n\nThe plan that started it\nShip the pipe first.\nLet people learn the fields by submitting.\nSpecimens would arrive once the door was open.\nA good form, plus moderation, would be enough for a first release.\nThe content could wait.\n\nWhat the empty shelf taught\nVisitors learned the form. They learned which fields were required and which types the menu offered.\nThey did not learn the craft. There was no specimen to copy, so they could not see when to use an artifact, when not to, or how a broken copy fails a check.\nSubmissions, when they came, echoed the form. They did not echo a practice, because no practice was on the shelf.\nThe queue could moderate nothing into a library. Moderation of an empty shelf is an empty queue.\n\nThe separation\nThe plan was about the pipe. The lesson is about the shelf.\nA library starts by putting specimens on the shelf.\nThe form stays. It is how the next specimen arrives.\nThe first specimens are part of the release, not a later content project.\n\nWhat would have counted as the other result\nA stranger opens one published specimen and can reuse it without asking the author.\nThat result is the goal named \"A stranger reuses one.\"\nAn empty shelf cannot meet it, because there is nothing to reuse.\n```\n\nThe plan is preserved so a later reader can see what was believed. The lesson does not edit the plan into a wiser plan after the fact. They sit side by side, and they do not match. That mismatch is the retrospective.\n\n## How a stranger checks it\n\nA stranger checks a retrospective of this kind by separating the two voices.\n\n1. Find the plan. It says the pipe comes first and the specimens can wait.\n2. Find the lesson. It says an empty shelf teaches the form and does not teach the craft, and a library starts by putting specimens on the shelf.\n3. Confirm the lesson is not written back into the plan as if the plan had always said it. If the piece only contains the wise version, it is advice, and it has lost the retrospective.\n4. Confirm the piece does not treat \"the form shipped\" as the finish line. The finish line it names is a stranger reusing one published specimen.\n\nIf you are about to ship a shelf, apply the lesson once: name the specimens that will be published in the same release as the form. Zero is the failure this retrospective records.\n","kind":"retrospective","stratum":"proof","license":"CC-BY-4.0","shot":"na","tags":["retrospective","shelf","library","form"],"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 retrospective when a project is about to ship the pipe and postpone the first specimens. It separates that plan from what an empty shelf actually taught.","avoid_when":"Do not use this piece as a feature list or as the plan for a new registry. It is what a finished empty shelf taught, after the form was already live.","eval_checks":[{"id":"RETRO-1","text":"The retrospective states the original plan and the lesson apart from each other, and the lesson is that an empty shelf teaches the form and not the craft.","how_checked":"Mark the plan paragraph and the lesson paragraph. Confirm they disagree, and that the lesson names published specimens as the start of a library."}],"published_at":"2026-09-24T21:59:21.000Z","updated_at":"2026-09-24T21:59:21.000Z","sensor":null,"edges":[{"from":"empty-shelf","to":"stranger-reuses-one","kind":"cites","title":"A stranger reuses one"}]}