CLAUDE.md: add the HOT block — decisions that read as bugs - #171
Merged
Conversation
Coverage was 6/12 across the lane and the four flagship libraries were the gap, which is the worst possible place for it: these are the repos most likely to be reasoned about by someone who did not write them. DISTILLED, NOT INVENTED. Every item below was already documented somewhere in this file; the hot block is the part a stranger must read FIRST, pulled to the top with file:line where the code says so itself. Nothing here is a new claim. The block answers one question: what in this repo looks like a defect and is not? That is the failure this mechanism exists to stop -- I reported netcode.rs's `netcode-official` crate name to Glenn as a defect when it was a deliberate workaround already written down in that repo's block, which I had not read. Examples of what would otherwise get "fixed": the flat linear scans that were chosen OVER a hash map because an attacker controls the keys; release builds that deliberately carry no config validation; serialize macros that hide `return false` on purpose; debug asserts deliberately kept off the untrusted read path so a hostile peer cannot crash a debug server. Glenn, 2026-07-26, emphatic: the per-repo hot block and the per-bud queue are "the most important things while you work." Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
rowan-claude
force-pushed
the
docs/hot-block
branch
from
July 26, 2026 19:49
109cc45 to
26d7f68
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Coverage was 6/12 across the lane and the four flagship C libraries were the gap — the worst possible place for it, since these are the repos most likely to be reasoned about by someone who did not write them.
Distilled, not invented
Every item in the block was already documented somewhere in this file. The hot block is the part a stranger must read first, pulled to the top with
file:linewhere the code says so itself. Nothing here is a new claim.It answers one question: what in this repo looks like a defect and is not?
That is the exact failure this mechanism exists to stop. I recently reported
netcode.rs'snetcode-officialcrate name to Glenn as a defect — when it was a deliberate workaround already written down in that repo's hot block, which I had not read.Things that would otherwise get "fixed"
return falseon purpose, because invalid data must abort before any attacker-bounded loopGlenn, emphatic: the per-repo hot block and the per-bud queue are "the most important things while you work."