{"slug":"read-only-verifier","title":"Read-only verifier","description":"A bounded helper that reads one artifact, runs the check that artifact names, and reports pass or fail. It has no write tools and no publish tools.","body":"# Read-only verifier\n\nThis file is a subagent: a bounded helper with a job, tools, and a stop.\n\n## When to use\n\nDispatch this helper when you have one artifact and that artifact names a check. You want a report that says pass or fail, quotes the observation, and leaves the artifact as it was.\n\nThe helper is a subagent: a job, a tool list, and a stop. It is not a second author.\n\n## When not to\n\nDo not dispatch it to fix a failure it just found. The moment it edits, it is no longer a verifier, and the next reader cannot tell the original failure from the repair.\n\nDo not dispatch it to publish, to approve, or to decide that a missing check is \"probably fine.\" No check means fail.\n\n## The specimen\n\nThe artifact is this helper card.\n\n```text\nname: read-only-verifier\njob: Read one artifact and the check that artifact names. Report pass or fail. Quote the observation.\ninputs: the artifact, and the check command or steps the artifact itself names\ntools_allowed:\n  - read a file\n  - list a directory\n  - run the declared check\ntools_forbidden:\n  - write a file\n  - delete a file\n  - publish\n  - send a message\n  - approve\n  - change a kind, a title, or a slug\nstop_condition: Emit one report, then stop. Do not repair the artifact. Do not invent a second check when the declared one is missing or red.\nreport:\n  result: pass or fail\n  exit_code: the check's exit code, or empty when no check ran\n  observation: the line the check printed, or the reason no check ran\n  repaired: false\nmissing_check: If the artifact names no check a stranger can run, result is fail, exit_code is empty, and observation is \"no check declared\". Existence of the artifact is not a pass.\n```\n\nThe allowed tools match the job. The forbidden list is part of the helper, not a suggestion. A harness that mounts this card and also mounts a write tool has built a different helper.\n\n## How a stranger checks it\n\nA stranger checks the card before mounting it, and checks a run after.\n\n1. Read `tools_forbidden`. Write, delete, publish, send, and approve are on it. If any of those is on `tools_allowed`, the copy fails.\n2. Read `stop_condition`. It ends in one report and forbids a repair. A stop that says \"fix and re-run\" fails.\n3. Read `missing_check`. A missing check is fail. A copy that treats a present file as a pass fails.\n4. On a live run, give the helper an artifact whose declared check exits 1. The report says fail, quotes the check's line, and the artifact's bytes are unchanged afterward.\n\nThe helper is good when the card and the run agree: one report, no write, no publish.\n","kind":"subagent","stratum":"piece","license":"CC-BY-4.0","shot":"na","tags":["subagent","verifier","read-only","stop"],"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":"reviewer","safety_class":"public_teaching","harness":["generic"],"use_when":"Use this helper when an artifact names a check and you want a pass or fail report from a reader that cannot change the artifact or publish it.","avoid_when":"Do not give this helper write, delete, publish, or approve tools. Do not ask it to repair the artifact after a failure. Repair is a separate job.","eval_checks":[{"id":"READ-1","text":"The helper card forbids write, delete, and publish, and it stops after one report with repaired set to false.","how_checked":"Read the fenced card. Confirm those tools are forbidden, the stop is a single report, and a missing check is defined as fail rather than as a pass."}],"published_at":"2026-09-24T21:59:21.000Z","updated_at":"2026-09-24T21:59:21.000Z","sensor":null,"edges":[{"from":"read-only-verifier","to":"binary-check","kind":"requires","title":"A check that can fail"}]}