Skip to content

Commit 1420eb5

Browse files
TMHSDigitalclaude
andauthored
docs: make CLAUDE.md the canonical home of the pinned contact-sheet set (#72)
Two files carried the calibration-set membership independently, and the set changes whenever a new example outclasses a member, so the copies were guaranteed to drift. CLAUDE.md now owns the list; the prompt points to it instead of naming members. Signed-off-by: fOuttaMyPaint <TMhospitalitystrategies@gmail.com> Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
1 parent df004b9 commit 1420eb5

2 files changed

Lines changed: 7 additions & 6 deletions

File tree

CLAUDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,7 @@ Stage with **explicit paths only** — never `git add -A` or `git add .`. Cursor
109109
## Quality Gates for Example Runs
110110

111111
- `docs/VISUAL-STYLE.md` is the **binding** render standard; deviations are defects.
112-
- **Contact-sheet gate:** composite the candidate hero beside the pinned calibration set — currently `armature-bend`, `damped-track-aim`, `bmesh-gear` — commit the composite under `docs/gallery/contact-sheets/`, link it in the PR body, and report per-criterion verdicts (stage darkness, wedge warmth, subject fill, saturation, thumbnail legibility) including mean luminance versus the calibration images. A claim without the committed composite is not acceptable evidence. The pinned set is updated (here and in `docs/new-example-prompt.md`) when a new example outclasses a member; the longer "calibration references" list in `docs/VISUAL-STYLE.md` is a style reference, not this contact-sheet set.
112+
- **Contact-sheet gate:** composite the candidate hero beside the pinned calibration set — currently `armature-bend`, `damped-track-aim`, `bmesh-gear` — commit the composite under `docs/gallery/contact-sheets/`, link it in the PR body, and report per-criterion verdicts (stage darkness, wedge warmth, subject fill, saturation, thumbnail legibility) including mean luminance versus the calibration images. A claim without the committed composite is not acceptable evidence. **This list is the canonical home of the pinned set** — update it here when a new example outclasses a member; `docs/new-example-prompt.md` points here rather than naming members. The longer "calibration references" list in `docs/VISUAL-STYLE.md` is a style reference, not this contact-sheet set.
113113
- **Falsification:** every check must be proven to fail once — break the contract, observe the non-zero exit, restore — with the probe and the measured error reported in the PR body. An assertion that cannot fail witnesses nothing.
114114
- **After gallery regeneration** (`python scripts/build_gallery.py`), read the **generated HTML** character by character — the `<img alt>` text and witnesses callouts in `docs/gallery/index.html` and `docs/gallery/<name>/index.html` — not just `examples/gallery.json`. Precedent: the `teaches.split(".")[0]` bug truncated 14/21 card alts at dotted API paths like `bmesh.ops` while the source JSON looked fine (fixed in PR #68).
115115

docs/new-example-prompt.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -98,11 +98,12 @@ objects are not visible unintentionally, and materials, lighting, background, an
9898
camera feel designed rather than left at Blender defaults.
9999

100100
Contact-sheet gate (required before shipping the still): place the new hero beside
101-
the pinned calibration set — currently `armature-bend`, `damped-track-aim`,
102-
`bmesh-gear` — and compare stage darkness, wedge warmth, subject fill, saturation,
103-
and thumbnail legibility side by side. Do not ship until the new image holds up in
104-
that lineup—not merely "looks fine alone." Update this named set (here and in
105-
`CLAUDE.md`) whenever a new example outclasses one of them. One successful render
101+
the pinned calibration set — canonical membership is listed in `CLAUDE.md`
102+
§ Quality Gates for Example Runs — and compare stage darkness, wedge warmth,
103+
subject fill, saturation, and thumbnail legibility side by side. Do not ship until
104+
the new image holds up in that lineup—not merely "looks fine alone." When a new
105+
example outclasses a member, update the pinned set in `CLAUDE.md`, its canonical
106+
home. One successful render
106107
command is not proof that the image is good, and neither is the second. Commit the
107108
composite under `docs/gallery/contact-sheets/`, link it in the PR body, and report
108109
per-criterion verdicts including mean luminance versus the calibration images — a

0 commit comments

Comments
 (0)