Skip to content

AGENTS.md

Latest commit

 

History

History
53 lines (40 loc) · 1.89 KB

AGENTS.md

File metadata and controls

53 lines (40 loc) · 1.89 KB

Donna — FHRR Memory + Living Note Graph

This project uses the donna CLI for persistent memory stored in nuggets.

The memory system now has three layers:

  • FHRR-backed fact recall for fast remember / recall / forget
  • A Zettelkasten-style graph in ~/.donna/graph/graph.json
  • A daily reflection pass that rewrites, merges, tags, and links notes

When to use Donna memory

Before searching for files or code patterns, check memory first:

donna recall "what you're looking for"

After discovering something useful, cache it:

donna remember <nugget> "<key>" "<value>"

What to remember

  • File locations: donna remember locations "auth handler" "src/auth/middleware.ts:47"
  • Commands: donna remember project "test cmd" "pytest tests/ -v"
  • Patterns: donna remember project "error handling" "uses Result type, never throws"
  • User preferences: donna remember prefs "style" "2-space indent, no semicolons"
  • Bug fixes: donna remember debug "CORS error" "add origin to allowlist in config.ts"

When note-level memory is better

Use the graph layer when the memory is more than a one-line fact:

  • A durable note with a title and paragraph of context
  • Something that should link to other notes
  • Something likely to be rewritten or merged later
  • Something the agent should revisit during daily cleanup

What NOT to remember

  • Anything longer than a short paragraph in the fact layer
  • Temporary context that will not matter next session
  • Information already in this file

Commands

donna remember <nugget> <key> <value>   # Store or update a fact
donna recall <query>                     # Search all nuggets
donna recall <query> --nugget <name>     # Search one nugget
donna forget <nugget> <key>              # Remove a fact
donna list                               # Show all nuggets
donna facts <nugget>                     # Show facts in a nugget