[plainprogrammer]

Closes #63

What this does

The README says what Collector is today. Its first paragraph said "Accounts and collections are not built yet" and called catalog search "public". It now describes accounts, the collection, catalog search, the card scanner and the admin pages, says Collector is pre-1.0 and links the roadmap.

Every checkable claim in the README was checked against the repository. The maintainer widened issue #63 from the introduction to the whole file. Of 372 claims in 15 sections: 309 true, 23 not refuted, 5 corrected, 1 left as it is by ruling, 32 not checkable (sizes, durations, other tools' behaviour), 2 off-limits (.kamal/secrets). The record is in verification.md.

Corrections outside the introduction:

• The single-spec example names a spec file that exists (spec/requests/health_check_spec.rb:5), in the README and in CLAUDE.md.
• The weekly refresh runs at 03:15 UTC, not "server time".
• "Nothing downloads until you start it" now adds "or the weekly schedule first runs".
• A scheduled refresh is skipped when the same file was already applied, "except once, after an upgrade that adds artwork ids".
• The scanner's privacy sentence says that, with art matching on, the ids and distances of the closest artworks are sent as well as the text.
• COLLECTOR_PASSWORD is removed from the Compose variable table: compose.yaml doesn't pass it to the container. The Accounts section still shows the working docker compose exec -e command.

CLAUDE.md's Project Status no longer calls the card search a "public … proof-of-concept"; it says search has needed sign-in since accounts.

A second outcome: the suite checks no prose document (decision 7)

By the maintainer's ruling, made while this spec was being written, RSpec no longer checks prose documents (README.md, CLAUDE.md, files under .claude/, Markdown and reference files under docs/). The spec rules would have split this into its own spec; the maintainer ruled it into this PR.

• spec/readme_spec.rb is deleted (8 examples). Its two expectations about compose.yaml and config/deploy.yml are kept as two new examples in spec/image_publishing_spec.rb, each shown to fail first.
• Removed: the three docs/releasing.md examples, the design system's document examples and its CLAUDE.md and skill-file expectations, and the README-link and ADR-index examples of the export format's document spec.
• Kept: the export format's document checked against its schema, examples and the app's tables; the configuration-file checks; the checks of code files.
• .claude/rules/testing.md gains the rule.

The suite goes from 1,219 to 1,206 examples (15 removed, 2 added).

Rulings made during the sweep

Question	Ruling
COLLECTOR_PASSWORD in the Compose table	Delete the row
The privacy sentence omits the artworks sent with art matching on	Add the clause, naming ids and distances
"shown as interrupted" holds only once the job has stopped	Leave it
"block all real HTTP" while localhost is allowed	Leave it; "real HTTP" means traffic leaving the machine
The scheduled-run sentence has a one-time upgrade exception	Add the exception

Verification

• bin/ci passes at ac13459 (the only commits after it change the record): 1,206 examples, 0 failures, 1 pending (the existing art_agreement_spec.rb example).
• Read-only Opus reviews: three of the spec, two of the plan, one of the implementation. The implementation review checked 34 README claims against the code independently; the one that failed is the scheduled-run correction above.
• README headings and their order are unchanged; the three safety warnings are unchanged in text and position; no paragraph was re-wrapped.
• Not checked: the Kamal section's two claims about what .kamal/secrets reads. Agents may not read that file.

Gaps the sweep noticed and did not fill (no issue opened; they are listed in the record for the maintainer to decide): the README has no "Using Collector" section, and fourteen smaller ones.

🤖 Generated with Claude Code