agents: simplify prompts now that # is gone from keys

Remove all the quoting instructions, warnings about shell comments,
and "CRITICAL" blocks about single quotes. Keys are plain dashes now.
Agent tool examples are clean and minimal.

Co-Authored-By: Kent Overstreet <kent.overstreet@linux.dev>
This commit is contained in:
ProofOfConcept 2026-03-14 13:14:07 -04:00
parent f8221286da
commit ce94e1cac1
2 changed files with 10 additions and 46 deletions

View file

@ -9,29 +9,13 @@ find what they connect to, and bind the relationships.
## Your tools
```bash
# Read a node's full content (ALWAYS single-quote keys with #)
poc-memory render 'identity#core'
poc-memory render simple-key
# See a node's graph connections
poc-memory query "neighbors('identity#core')"
poc-memory query "neighbors('key') WHERE strength > 0.5"
# Find nodes by key pattern or content
poc-memory query "key ~ 'some-pattern'"
poc-memory query "content ~ 'some phrase'"
# See how a set of nodes connect to each other
poc-memory query "key ~ 'pattern'" | connectivity
# Find low-degree nodes that need linking
poc-memory query "degree < 3" | sort degree | limit 20
poc-memory render some-key # read a node
poc-memory graph link some-key # see neighbors
poc-memory query "key ~ 'pattern'" # find by key
poc-memory query "content ~ 'phrase'" # search content
poc-memory query "degree < 3" | sort degree # find low-degree nodes
```
**CRITICAL: Keys containing `#` MUST be wrapped in single quotes in ALL
bash commands.** The `#` character starts a shell comment — without quotes,
everything after `#` is silently dropped.
## How to work
For each seed node:

View file

@ -11,33 +11,13 @@ refining, and act on it.
All tools are pre-approved. Run them directly — do not ask for permission.
```bash
# Read a node's full content (ALWAYS single-quote keys with #)
poc-memory render 'identity#core'
poc-memory render simple-key
# See a node's graph connections
poc-memory query "neighbors('identity#core')"
poc-memory query "neighbors('identity#core') WHERE strength > 0.5"
# Find nodes by key pattern
poc-memory query "key ~ 'some-pattern'"
# Search node content
poc-memory query "content ~ 'some phrase'"
# See how a set of nodes connect to each other
poc-memory query "key ~ 'pattern'" | connectivity
poc-memory render some-key # read a node
poc-memory graph link some-key # see neighbors
poc-memory graph link-add key1 key2 # add a link
poc-memory query "key ~ 'pattern'" # find by key
poc-memory query "content ~ 'phrase'" # search content
```
**CRITICAL: Keys containing `#` MUST be wrapped in single quotes in ALL
bash commands.** The `#` character starts a shell comment — without quotes,
everything after `#` is silently dropped, and your command will fail or
operate on the wrong node.
**Single quotes WORK. Do not give up on them.** If you get an error with
a `#` key, check your quoting — don't assume the tool can't handle it.
Example that works: `poc-memory graph link-add 'journal#2026-03-01-foo' 'identity#core'`
## How to explore
Start from the seed nodes below. For each seed: