g-eskayo/marvin/lexicon

Lexicon

Shared vocabulary between Giles and Claude. Compressed mental models.

When to Run Autonomously

• 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

Adding an Entry

Edit ~/.claude/lexicon.md. Append under the most relevant section heading, or create a new section if concept belongs to a new domain.

Format:

- **term** — definition. Image or usage context if helpful.

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

Reviewing

When asked to review the lexicon: read ~/.claude/lexicon.md, flag any entries that have drifted, become unused, or contradict each other. Propose updates.

Sections

Current sections in lexicon.md:

• Meta — terms about the skill/agent system itself
• Add new sections as concepts cluster into domains