doc: CLAUDE.md - a rule against committing build output, and two stale notes

[jll63]

(Written by Claude Code, on behalf of @jll63.)

CLAUDE.md only; no code, no tests.

A rule against committing build output

#103 merged 415 files of b2 output - 613 MiB expanded, 94 MiB in the pack, on a
repository of about 3 MB - days after #108 added the bin/ ignore rule intended
to prevent it. The branch was cut before that rule landed, and an ignore rule has
no effect on a path that is already tracked, so the merge carried them in.

Nothing in the build or in review catches this, and #117 can only untrack them.
A rewrite of develop is not available as a remedy: the superproject pins this
library by SHA and its bot bumps the pin within minutes of every merge, so
rewriting orphans commits boostorg/boost already points at; and the blobs stay
reachable through refs/pull/<n>/head, which a maintainer cannot delete. So the
rule goes next to the workflow it belongs to - stage named paths, never
git add <dir>, and ask before committing a build artefact or any file over 1MB.

Two stale notes in the registry-affinity section

"One thing deliberately does not participate", followed by two things. #113
collapsed the original Two things ... and both are documented as such: bullets
into a single sentence, because use_classes had just started participating - but
the sentence goes on to name both the interop headers and the C++26
register_classes. Restored to bullets for the two that are left.

"the any and type_erasure interop headers are untouched". #116 touched all
three of them, and had to: #113 gave virtual_ a registry parameter, and their
validate_method_parameter specializations still spelled virtual_<T>, which
after that change matches only the defaulted argument. The affinity claim - the
actual point of the paragraph - does survive, so the note now says that a
virtual_any contributes no affinity, separates it from a parameter spelling a
registry, and records why a specialization there cannot go back to the bare
spelling.

The PCH paragraph names one override-carrying header; the scan looks for two.
test/CMakeLists.txt has scanned for test_checked_registry.hpp alongside
test_capture_errors.hpp since #93. The sentence three lines above it, "do not add
a fourth marker", already counts three markers, so only the enumeration was stale.

🤖 Generated with Claude Code

[cppalliance-bot]

An automated preview of the documentation is available at https://118.openmethod.prtest3.cppalliance.org/libs/openmethod/doc/html/index.html

If more commits are pushed to the pull request, the docs will rebuild at the same URL.

2026-09-19 16:06:56 UTC