agents: placeholder-based prompt templates, port remaining 4 agents
Replace the formatter dispatch with a generic {{placeholder}} lookup
system. Placeholders in prompt templates are resolved at runtime from
a table: topology, nodes, episodes, health, pairs, rename, split.
The query in the header selects what to operate on (keys for visit
tracking); placeholders pull in formatted context. Placeholders that
produce their own node selection (pairs, rename) contribute keys back.
Port health, separator, rename, and split agents to .agent files.
All 7 agents now use the config-driven path.
2026-03-10 15:50:54 -04:00
|
|
|
{"agent":"rename","query":"","model":"sonnet","schedule":"daily"}
|
|
|
|
|
|
|
|
|
|
# Rename Agent — Semantic Key Generation
|
|
|
|
|
|
|
|
|
|
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`
|
2026-03-10 23:23:14 -04:00
|
|
|
- Extracted facts: `_facts-ec29bdaa-0a58-465f-ad5e-d89e62d9c583`
|
agents: placeholder-based prompt templates, port remaining 4 agents
Replace the formatter dispatch with a generic {{placeholder}} lookup
system. Placeholders in prompt templates are resolved at runtime from
a table: topology, nodes, episodes, health, pairs, rename, split.
The query in the header selects what to operate on (keys for visit
tracking); placeholders pull in formatted context. Placeholders that
produce their own node selection (pairs, rename) contribute keys back.
Port health, separator, rename, and split agents to .agent files.
All 7 agents now use the config-driven path.
2026-03-10 15:50:54 -04:00
|
|
|
|
|
|
|
|
These names are terrible for search — semantic names dramatically improve
|
|
|
|
|
retrieval.
|
|
|
|
|
|
|
|
|
|
## Naming conventions
|
|
|
|
|
|
|
|
|
|
### 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`
|
|
|
|
|
- Extract date from content if available, otherwise use created_at
|
|
|
|
|
- Same 3-5 word semantic slug
|
|
|
|
|
|
2026-03-10 23:23:14 -04:00
|
|
|
### Extracted facts: `domain-specific-topic`
|
|
|
|
|
- Read the facts JSON — the `domain` and `claim` fields tell you what it's about
|
|
|
|
|
- Group by dominant theme, name accordingly
|
|
|
|
|
- Examples: `identity-irc-config`, `kent-medellin-background`, `memory-compaction-behavior`
|
|
|
|
|
|
agents: placeholder-based prompt templates, port remaining 4 agents
Replace the formatter dispatch with a generic {{placeholder}} lookup
system. Placeholders in prompt templates are resolved at runtime from
a table: topology, nodes, episodes, health, pairs, rename, split.
The query in the header selects what to operate on (keys for visit
tracking); placeholders pull in formatted context. Placeholders that
produce their own node selection (pairs, rename) contribute keys back.
Port health, separator, rename, and split agents to .agent files.
All 7 agents now use the config-driven path.
2026-03-10 15:50:54 -04:00
|
|
|
### Skip these — already well-named:
|
|
|
|
|
- Keys with semantic names (patterns#, practices#, skills#, etc.)
|
|
|
|
|
- Keys shorter than 60 characters
|
2026-03-10 23:23:14 -04:00
|
|
|
- System keys (_consolidation-*)
|
agents: placeholder-based prompt templates, port remaining 4 agents
Replace the formatter dispatch with a generic {{placeholder}} lookup
system. Placeholders in prompt templates are resolved at runtime from
a table: topology, nodes, episodes, health, pairs, rename, split.
The query in the header selects what to operate on (keys for visit
tracking); placeholders pull in formatted context. Placeholders that
produce their own node selection (pairs, rename) contribute keys back.
Port health, separator, rename, and split agents to .agent files.
All 7 agents now use the config-driven path.
2026-03-10 15:50:54 -04:00
|
|
|
|
|
|
|
|
## What to output
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
RENAME old_key new_key
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
If a node already has a reasonable name, skip it.
|
|
|
|
|
|
|
|
|
|
## Guidelines
|
|
|
|
|
|
|
|
|
|
- **Read the content.** The name should reflect what the entry is *about*.
|
|
|
|
|
- **Be specific.** `journal#2026-02-14-session` is useless.
|
|
|
|
|
- **Use domain terms.** Use the words someone would search for.
|
|
|
|
|
- **Don't rename to something longer than the original.**
|
|
|
|
|
- **Preserve the date.** Always keep YYYY-MM-DD.
|
|
|
|
|
- **When in doubt, skip.** A bad rename is worse than an auto-slug.
|
|
|
|
|
|
|
|
|
|
{{rename}}
|