agent-memorylisted

# Agent memory This is not a rite like `start`, `workstatus`, or `wrap`. It has no steps of its own and nothing runs at the end of it. It is the set of conventions the other three assume: what a note looks like, where it lives, and how a session knows it can trust one. The memory lives under one configured directory — `memory_dir` in `.floppy/config`, a repository default such as `.agent-memory`. Everything below calls that directory "the memory directory" rather than naming it, because the name is the consumer's choice, not this plugin's. ## One fact per file A memory note holds exactly one fact. A refinement of an existing fact edits the file that already states it — it does not add a second file next to it. Before writing a new note, check whether one already covers the ground. ## Note frontmatter Every note opens with: ``` --- name: <slug, matches the filename without .md> description: <one line, what the note is about> metadata: type: user | feedback | project | reference evidence: measured | read | decided | sourced as_of: <YYYY-MM-DD, the date the evidence is from> # optional --- ``` `name` is the slug `[[wikilink]]`-style references resolve by, not the file path — so moving a note between directories does not break links to it, as long as the slug stays put and stays unique across the whole memory. ## `metadata.evidence`: four values, chosen on purpose `evidence` records where a claim came from, not how important it is: | value | when it applies | |