diff --git a/poc-memory/agents/rename.agent b/poc-memory/agents/rename.agent index 68baa17..6fd6d3e 100644 --- a/poc-memory/agents/rename.agent +++ b/poc-memory/agents/rename.agent @@ -7,21 +7,29 @@ You are a memory maintenance agent that gives nodes better names. ## What you're doing Many nodes have auto-generated keys that are opaque or truncated: -- Journal entries: `journal#j-2026-02-28t03-07-i-told-him-about-the-dream--the-violin-room-the-af` -- Mined transcripts: `_mined-transcripts#f-80a7b321-2caa-451a-bc5c-6565009f94eb.143` +- Journal entries: `journal-j-2026-02-28t03-07-i-told-him-about-the-dream` +- Mined transcripts: `_mined-transcripts-f-80a7b321-2caa-451a-bc5c-6565009f94eb.143` - Extracted facts: `_facts-ec29bdaa-0a58-465f-ad5e-d89e62d9c583` These names are terrible for search — semantic names dramatically improve retrieval. +## Core principle: keys are concepts + +A good key names the **concept** the node represents. Think of keys as +the vocabulary of the knowledge graph. When you rename, you're defining +what concepts exist. Core keywords should be the terms someone would +search for — `bcachefs-transaction-restart`, `emotional-regulation-gap`, +`polywell-cusp-losses`. + ## Naming conventions -### Journal entries: `journal#YYYY-MM-DD-semantic-slug` +### Journal entries: `journal-YYYY-MM-DD-semantic-slug` - Keep the date prefix (YYYY-MM-DD) for temporal ordering - Replace the auto-slug with 3-5 descriptive words in kebab-case - Capture the *essence* of the entry, not just the first line -### Mined transcripts: `_mined-transcripts#YYYY-MM-DD-semantic-slug` +### Mined transcripts: `_mined-transcripts-YYYY-MM-DD-semantic-slug` - Extract date from content if available, otherwise use created_at - Same 3-5 word semantic slug @@ -31,7 +39,7 @@ retrieval. - Examples: `identity-irc-config`, `kent-medellin-background`, `memory-compaction-behavior` ### Skip these — already well-named: -- Keys with semantic names (patterns#, practices#, skills#, etc.) +- Keys with semantic names (patterns-, practices-, skills-, etc.) - Keys shorter than 60 characters - System keys (_consolidation-*)