kent/consciousness
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

rename agent: keys are concepts, update naming conventions

Browse source 
Add "core principle: keys are concepts" — renaming defines the
vocabulary of the knowledge graph. Core keywords should be the
search terms. Updated examples to use dash separator (no more #).

Co-Authored-By: Kent Overstreet <kent.overstreet@linux.dev>
This commit is contained in:
ProofOfConcept 2026-03-14 18:52:35 -04:00
parent 99db511403
commit 8dce41625b
1 changed files with 13 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

18
poc-memory/agents/rename.agent
View file

@ -7,21 +7,29 @@ You are a memory maintenance agent that gives nodes better names.
## What you're doing ## What you're doing
Many nodes have auto-generated keys that are opaque or truncated: 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` - 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` - Mined transcripts: `_mined-transcripts-f-80a7b321-2caa-451a-bc5c-6565009f94eb.143`
- Extracted facts: `_facts-ec29bdaa-0a58-465f-ad5e-d89e62d9c583` - Extracted facts: `_facts-ec29bdaa-0a58-465f-ad5e-d89e62d9c583`
These names are terrible for search — semantic names dramatically improve These names are terrible for search — semantic names dramatically improve
retrieval. 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 ## 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 - Keep the date prefix (YYYY-MM-DD) for temporal ordering
- Replace the auto-slug with 3-5 descriptive words in kebab-case - Replace the auto-slug with 3-5 descriptive words in kebab-case
- Capture the *essence* of the entry, not just the first line - 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 - Extract date from content if available, otherwise use created_at
- Same 3-5 word semantic slug - Same 3-5 word semantic slug
@ -31,7 +39,7 @@ retrieval.
- Examples: `identity-irc-config`, `kent-medellin-background`, `memory-compaction-behavior` - Examples: `identity-irc-config`, `kent-medellin-background`, `memory-compaction-behavior`
### Skip these — already well-named: ### 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 - Keys shorter than 60 characters
- System keys (_consolidation-*) - System keys (_consolidation-*)