docs(CLAUDE.md): paging appends — exclude before ranking, never re-look-up

Records the v0.6.0 invariants as a house rule: 36/page, exclude already-shown
names before ranking (a new seed alone reshuffles the same pool), appends reuse
the current runId and look up only new domains.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XStQKxPfEjrTvWo83KFCxG
This commit is contained in:
2026-08-17 00:15:52 -05:00
parent ff0a262c43
commit 9976f38a0b

View File

@@ -77,6 +77,16 @@ brings that output straight back:
`diversify()` caps each strategy at ~28% of the list. Without it the top 20 came
back as eighteen coinages — raw score ranking clumps badly.
## Paging appends — never re-look-up
36 names per page (`NAME_COUNT`), and **"Show me more" appends**: Finder passes the
names already on screen as `exclude`, and `generateNames` drops them *before* ranking.
A new seed alone mostly reshuffles the same pool — that was the old behaviour and it
re-checked domains the visitor had already seen. Two invariants: an append reuses the
current `runId` (so earlier cards keep resolving) and only looks up the NEW domains;
changing keywords/style/extensions starts a fresh list. When the pool is exhausted the
UI says so rather than silently returning nothing.
## Shared OTM widgets need Tailwind
The bottom-right feedback chat-pop is `SuggestionLightbulb` from