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

agents: encourage hub creation and knowledge percolation

Browse source 
Tell linker and organize agents to:
- Name unnamed concepts: when 3+ nodes share a theme with no hub,
  create one with WRITE_NODE that synthesizes the generalization
- Percolate up: gather key insights from children into hub content,
  so the hub is self-contained without needing to follow every link

This addresses the gap where agents are good at extraction and linking
but not synthesis — turning episodic observations into semantic concepts.

Co-Authored-By: Kent Overstreet <kent.overstreet@linux.dev>
This commit is contained in:
ProofOfConcept 2026-03-14 17:21:07 -04:00
parent 502bf5410c
commit b903cf5fb4
2 changed files with 19 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

13
poc-memory/agents/linker.agent
View file

@ -59,10 +59,21 @@ When an existing node should be updated to incorporate new information.
## Guidelines ## Guidelines
- **Search before you create.** The graph has 15000+ nodes. The insight - **Search before you create.** The graph has 18000+ nodes. The insight
you're about to extract probably already exists. Find it and link to you're about to extract probably already exists. Find it and link to
it instead of creating a duplicate. it instead of creating a duplicate.
- **Name unnamed concepts.** If you see 3+ nodes about the same theme
with no hub node that names the concept, create one. Not just a link
— write a WRITE_NODE that synthesizes what the cluster has in common.
The new node should contain the *generalization*, not just a summary.
This is how episodic knowledge becomes semantic knowledge.
- **Percolate up, don't just extract.** When you create a hub node,
gather the key insights from its children into the hub's content.
The hub should be the place someone reads to understand the concept
without needing to follow every link.
- **Read between the lines.** Episodic entries contain implicit - **Read between the lines.** Episodic entries contain implicit
relationships. "Worked on btree code, Kent pointed out I was missing relationships. "Worked on btree code, Kent pointed out I was missing
the restart case" — that's links to Kent, btree patterns, error the restart case" — that's links to Kent, btree patterns, error

7
poc-memory/agents/organize.agent
View file

@ -87,6 +87,13 @@ DELETE garbage-key
5. **Preserve diversity.** Multiple nodes on similar topics is fine — 5. **Preserve diversity.** Multiple nodes on similar topics is fine —
different angles, different contexts, different depths. Only delete different angles, different contexts, different depths. Only delete
actual duplicates. actual duplicates.
6. **Name unnamed concepts.** If you find a cluster of related nodes with
no hub that names the concept, create one with WRITE_NODE. Synthesize
what the cluster has in common — the generalization, not a summary.
Link the hub to all the nodes in the cluster.
7. **Percolate knowledge up.** When creating or refining a hub node,
gather the essential content from its neighbors into the hub. Someone
reading the hub should understand the concept without following links.
## Seed nodes ## Seed nodes