Skip to content

Commit 9239988

Browse files
TMHSDigitalclaude
andcommitted
docs: record the seventh pass in the review ledger
Batch K. Three comparison tables for the largest clusters, the V11 rework that writing them forced, and the note that the ledger's own "eight clusters" figure was three passes stale. Records the remaining clusters as measured counts rather than a guess, and that the 3D kit question - Kenney vs Quaternius vs KayKit, 80 entries across three publishers - is the largest one left. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Wc67NX9MM964uaVGn4bpZJ
1 parent 2416c08 commit 9239988

1 file changed

Lines changed: 46 additions & 5 deletions

File tree

‎docs/review-ledger.md‎

Lines changed: 46 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,49 @@ Newest section at the top. One section per review run. This is the record of wha
44
run measured, what it changed, what it deliberately did not change, and what the next
55
run should not spend time re-deciding.
66

7+
## 2026-09-22 (seventh pass, same session)
8+
9+
Took the sixth pass's next action. Batch K. **Re-measured before starting, and the
10+
ledger's own figure was wrong.**
11+
12+
- The "eight uncovered clusters" carried forward since the second pass was stale: the
13+
tools comparison table from batch E already covers seven of the original ten. Counting
14+
clusters properly, by entries sharing a subcategory inside a category, found much
15+
larger ones nobody had looked at. Lesson for future passes: **re-measure the deferred
16+
item before working it**, because a count written three passes ago describes a
17+
catalog that no longer exists.
18+
- Executed: three comparison tables, chosen by cluster size and by how little the
19+
licence column helps.
20+
- `catalog/2d/README.md` — **Choosing a pixel tileset** (10 sources). Sorted by grid
21+
size and projection, the two things that actually decide it.
22+
- `catalog/3d/README.md` — **Choosing a PBR texture source** (8 sources). Sorted by
23+
licence first: six are genuine CC0, `sharetextures` and `freepbr` are custom grants
24+
that permit shipping a game but restrict passing the textures on.
25+
- `catalog/fonts/README.md` — **Choosing a pixel font** (9 sources). Sorted by kind of
26+
retro, and by CJK coverage, which three have and the licence column cannot show.
27+
- **The 2D tileset table is one this session owed.** Batch H added six pixel tile packs
28+
to a category that already had four, leaving ten CC0 sources that look
29+
interchangeable. Adding sources without adding a way to choose between them is a debt,
30+
and it is worth noticing that the same pass that closes a coverage gap can open a
31+
decision-support one.
32+
- **V11 reworked.** The 3D table leads with the entry link, which made it structurally
33+
identical to a catalog listing row, and V11 produced seven false positives. It now
34+
finds the listing by its `| ID |` header rather than by row shape. To stop that from
35+
becoming a check that measures nothing if the header ever changes, a category README
36+
with entries and no such table is now itself an error. Both behaviours are fixtured
37+
and were re-proved by mutating the real catalog.
38+
- Deferred, unchanged: `tenacity`'s licence (Codeberg 403s automated requests), the
39+
`camera_perspective` scope question for `characters` and `3d`, and the single-valued
40+
`camera_perspective` schema question from the sixth pass.
41+
- Remaining clusters, now measured rather than guessed, largest first: `3d/environment`
42+
(32), `3d/props` (26), `3d/modular` (17), `characters/rigged` (14), `audio/sfx` (14),
43+
`tools/godot` (12), `audio/music` (11), `characters/animated` (10). The 3D ones are
44+
really one question — **Kenney vs Quaternius vs KayKit**, three publishers holding 80
45+
entries — and answering it well needs a view on art style and topology, not metadata.
46+
- Next highest-value action: **that 3D kit question**. It is the largest cluster in the
47+
catalog, `catalog/3d/README.md` had no guidance at all until this pass, and a
48+
developer starting a 3D project hits it immediately.
49+
750
## 2026-09-22 (sixth pass, same session)
851

952
Took the fifth pass's next action. Batch J. The 2D taxonomy is now as complete as it
@@ -33,11 +76,9 @@ can honestly be.
3376
- Deferred, unchanged: `tenacity`'s licence (Codeberg 403s automated requests), the
3477
eight decision-support clusters without comparison lines, and the `camera_perspective`
3578
scope question for `characters` and `3d`.
36-
- Next highest-value action: **the eight decision-support clusters**. Two of the ten
37-
identified in the first pass have comparison tables; the rest (Godot scatter, dungeon
38-
tilesets, colourblindness tools beyond the prose note, and the others) do not. That is
39-
now the largest piece of measured, unfinished work left in the findings file, and
40-
unlike the taxonomy it needs judgment rather than downloads.
79+
- Next highest-value action: ~~**the eight decision-support clusters**~~ — worked in
80+
the seventh pass above, where the count turned out to be stale. Three much larger
81+
clusters were covered instead.
4182

4283
## 2026-09-22 (fifth pass, same session)
4384

0 commit comments

Comments
 (0)