Fix two stale CLAUDE.md claims the Stage 5 exit audit's own sweep missed - #49
Merged
Conversation
Criterion 10 had eight stale claims, not the six recorded in Stage 5's status table. Both misses are the exact class that audit was about, and both are recorded in the files themselves rather than quietly corrected. planning/CLAUDE.md called docs/planning/releases.md "a sustained argument that PyFlow should not have a release process yet" and data/releases.yaml an empty file "correct rather than incomplete". Both stopped being true when reaching the MVP fired that document's own trigger. The audit grepped for "no release process"; this paragraph says "should not have a release process yet" -- the same claim in words the pattern did not match. docs/architecture/CLAUDE.md still anchored sequences.md's checkpointing placeholder to "the specific roadmap task that will build it (TASK-034)". The audit re-anchored sequences.md and did not re-read its companion CLAUDE.md in the same change -- a one-file-deep sweep, immediately after writing a rule against exactly that. TASK-034 landed without building checkpointing, which Stage 5 Criterion 4 explicitly allows, so the placeholder stayed accurate while its anchor pointed at a closed task. Swept every other CLAUDE.md for the same class; nothing further found. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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.
Criterion 10 had eight stale claims, not the six #48 recorded. Both
misses are the exact class that audit was about, and both are recorded in
the files themselves rather than quietly corrected (root
CLAUDE.md'sIntegrity section).
planning/CLAUDE.mdCalled
docs/planning/releases.md"a sustained argument that PyFlowshould not have a release process yet", and
data/releases.yamlan emptyfile "correct rather than incomplete". Both stopped being true in #48,
when reaching the MVP fired that document's own trigger.
Why the sweep missed it: the audit grepped for
no release process;this paragraph says "should not have a release process yet" — the
same claim in words the pattern did not match. An instance of the stated
limits of
docs/practices.md's "A stage's documentation sweep is a grep,not a diff review", now recorded as one.
The paragraph is rewritten to make
releases.yamlthe worked example ofa trigger firing, which is more useful than the example of one holding
that it used to be.
docs/architecture/CLAUDE.mdStill anchored
sequences.md's checkpointing placeholder to "thespecific roadmap task that will build it (TASK-034)".
Why the sweep missed it: #48 re-anchored
sequences.mditself anddid not re-read its companion
CLAUDE.mdin the same change — aone-file-deep sweep, immediately after writing a rule against exactly
that. TASK-034 landed without building checkpointing, which Stage 5
Criterion 4 explicitly allows, so the placeholder stayed accurate while
its anchor pointed at a closed task.
Scope
Prose only, two
CLAUDE.mdfiles, no code. Every otherCLAUDE.mdwasswept for the same class — nothing further found;
examples/golden-demos/CLAUDE.md's "seven demos" count checks outagainst the tree.
🤖 Generated with Claude Code