lexicon

Topics in the source

• Lexicon
• When to Run Autonomously
• Adding an Entry
• Reviewing
• Sections

Shared vocabulary between Giles and Claude. Compressed mental models. New concept coined mid-conversation that will recur Term used 2+ times with stable meaning → worth formalising Image or metaphor that captures something complex in few words Existing entry is wrong or needs sharpening based on usage Edit /.claude/lexicon.md. Append under the most relevant section heading, or create a new section if concept belongs to a new domain. Format: Rules: Definition = shortest accurate statement Include the image if the term works visually (a metaphor, a shape, a dynamic) No synonyms for existing terms — update the existing entry instead If a term shifts meaning, update + note the shift Only words MARVIN and Gil use with a meaning of their own. A general glossary of someone else's field (MCP, OAuth, ...) goes in /.agents/best-practices/ -glossary.md, with a line under Elsewhere pointing at it The whole lexicon is pasted into every session, capped at 2,500 characters (LEXICONMAX in lib/sessionstartreport.py, PR #1124). Past that the tail is cut, so keep entries short When asked to review the lexicon: read /.claude/lexicon.md, flag any entries that have drifted, become unused, or contradict

This is an excerpt. Refer to the complete source and its current requirements.