Repository navigation
Corollary: generated artifacts: hand-edited output reverses it; rendered images have a reproduction limit - #37
Merged
Merged
Conversation
…red images have a reproduction limit Adds two paragraphs to "Corollary: generated artifacts": - Once anyone edits a generator's output, re-running it destroys that work silently. Say so where it is run (refuse to overwrite a file modified since the last write, or write beside it), and retire the generator once the output becomes the source of truth. - For a rendered image, "reproduces" has a limit: matplotlib writes its version into every PNG and a tight bounding box follows font metrics, so bytes and even pixel dimensions differ across machines. Compare byte-for-byte only on the maintaining machine; elsewhere compare presence and say so. Petition: claude-notes briefings/petition-carry-forward-2026-09-24b.md items 3 and 10; approved by Jones 2026-09-24. Co-Authored-By: Claude Opus 5.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.
Why
Corollary: generated artifacts runs one way: the script is the source of truth and regenerating must reproduce what shipped. It is silent on the case every sighting hit, where a person edits the output. From then on the generator destroys work, and still runs and still succeeds; a README warning is not where the runner is when they run it. Separately, the corollary plus Part 5's committed figures invite a byte comparison of PNGs that only the originating machine can pass: matplotlib writes its version into the PNG, and a tight bounding box follows font metrics, so even pixel dimensions differ across machines. The rule leaves the reader to discover that limit.
Sightings
tEXtchunk; 1388x586 locally against 1389x587 on CI).What changes
Approved by Jones on 2026-09-24. Drafted in claude-notes:
briefings/petition-carry-forward-2026-09-24b.mditems 3 and 10.🤖 Generated with Claude Code