The README had become a manual pasted into the front door: 1466 lines,
with sections that docs/ already covers in more depth than the README
did. Length is not thoroughness. A reader who bounces at screen three
never reaches the reference material that justified the length.

Removed what docs/ owns outright. The dashboard section restated
docs/dashboard.md, and Reactive ERB restated docs/realtime.md for 167
lines, so both are now the argument, the smallest working example, and a
link. The Cloudflare capability subsections collapse to one paragraph
each, keeping the mapping table and the Solid Queue ordering comparison,
which live nowhere else.

Removed what the README said twice. "When to use it" and the new "Is it
worth installing here?" were the same section 1100 lines apart; the
early one now carries the domain list. Invoking an object explained
per-adapter lock deadlines that docs/correctness.md documents properly.

Removed what was no longer true. The Status list claimed "Implemented
and tested in 0.4" at version 0.14.1 and said the supervisor does not
replace a crashed role, which docs/roadmap.md lists as implemented.

Kept every fact that has no other home: the keyed-alarm section, the
configuration defaults table, the CLI worker-count flags, connects_to
for a separate actor database, the keyword-disambiguation rule,
InvalidRejectionCode, and the turbo-rails dependency.

The README was still twice the size of its JavaScript sibling at 1175
lines, and the difference was not extra capability. It was reference
material sitting on the front door: every reminder rule, every
configuration default, every CLI flag, and two registration examples,
all of which a reader passes on the way to deciding whether to install
anything.

Moved rather than deleted, because most of it had no other home.
docs/reminders.md is new and holds the keyed-alarm rules, the composed
name limit, the one-alarm-for-a-whole-queue drain, and reconciliation
for self-scheduling actors; docs/architecture.md now links there instead
of into a README heading. docs/operations.md gains the configuration
defaults table, the worker-count flags, the upgrade sequence, the
RuboCop exclusion, the Sorbet note, and the extension-component
contract. docs/architecture.md gains register_effect and
register_commit_action with their signatures.

Deleted only what was said twice. The table of contents duplicated the
headings GitHub already renders. A second example actor demonstrated
what the ticket sale demonstrates. Actor identity was three paragraphs
that fit in one, inside the section that defines an actor.

The README is now 528 lines and keeps what only it can say: the ticket
sale, the lock argument, who should not install this, the Durable
Objects mapping, and one worked example per capability with a link to
the guide behind it.

The lead actor declared observable :remaining and the ERB beside it
rendered that value in a span while a component observed :holds. Neither
worked. A scalar span raises ArgumentError unless the observable is
declared broadcast: :value, and a component dependency must itself be a
declared observable or ComponentRegistration raises
UnknownComponentDependency.

remaining now carries broadcast: :value and holds is declared, which is
also the clearer teaching example: one observable opts into sending its
value to every authorized subscriber, the other only invalidates, which
is what the paragraph under it describes.

Verified against this branch rather than read: broadcasts_observable_value?
is true for remaining, holds resolves as a dependency, and reserve,
duplicate reserve, and expire behave as the text claims.