Skip to content

Write down what looking, examining, and searching each ask - #59

Merged
gitosaurus merged 1 commit into
mainfrom
docs/verb-ladder
Aug 13, 2026
Merged

Write down what looking, examining, and searching each ask#59
gitosaurus merged 1 commit into
mainfrom
docs/verb-ladder

Conversation

@gitosaurus

Copy link
Copy Markdown
Owner

Two paragraphs of prose into games/lexicon.arch, no code.

The first records the rule that a word belongs to whichever definition claims it first, and that a later claim on a word already spoken for is dropped silently. This file is included ahead of every game's own lexicon, which makes adding a word here a change no game can opt out of. That rule is nowhere written down, and gorreven_lex.arch:36 carries a syn : 'examine' that has never done anything as a result — evidence turned up while surveying #50.

The second says what look, look at, and search each ask, and why 'examine' is a synonym of the first rather than the last:

#   look          what is here?
#   look at, x    what is this thing showing me?
#   search        what is this thing withholding?

Examining takes what an object offers; searching takes what it keeps back.

There is no baseline 'search' yet — that is #50, and the third rung is described here as the thing a game defines for itself, which is true today. When #50 lands, that sentence is the one line of this comment that changes.

Risk: none. Comments are stripped before compilation, so tests/golden/check.sh passes with both .acx files byte for byte identical. 18 test suites, 0 failures.

🤖 Generated with Claude Code

https://claude.ai/code/session_013Ui8UMgev1U8LW5iyQdSsJ

The three are not the same question.  "look" asks what is here, "look at"
asks what a thing is showing, and "search" asks what it is withholding.
Examining takes what an object offers; searching takes what it keeps back,
which is why the one leaves the world alone and the other rarely does.

That 'examine' is a synonym of 'look' is a convention and not a semantics --
the English word sits nearer the thorough thing -- and it was worth saying
out loud, because it is the kind of decision that reads as an oversight to
anyone who wasn't there when it was made.

The other new paragraph is the rule that a word belongs to whichever
definition claims it first; a later claim on a word already spoken for is
dropped in silence.  This file is included ahead of every game's own
lexicon, so a word added here is one no game can take back.  Nothing in the
repository said so, and "The Gorreven Papers" carries a dead 'syn' line that
shows how easy it is not to know.

Comments are stripped before compilation, so both goldens are byte for byte
unchanged.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Ui8UMgev1U8LW5iyQdSsJ
@gitosaurus
gitosaurus merged commit 10d0496 into main Aug 13, 2026
2 checks passed
@gitosaurus
gitosaurus deleted the docs/verb-ladder branch August 13, 2026 14:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant