para-memory-files

A PARA-based file system organizes persistent memory across sessions using three layers: a knowledge graph of YAML facts, daily timeline notes, and tacit knowledge in MEMORY.md. It enables durable recall, fact supersession, and weekly synthesis.

Structure long-term knowledge management by creating per-entity folders with summary.md and items.yaml for durable facts. Apply YAML schemas to atomic facts with unique IDs and timestamps, enforcing rules like never deleting facts and archiving inactive items.

Capture daily notes under memory/YYYY-MM-DD.md to record raw events and timelines. Store tacit knowledge about user patterns and operating preferences in MEMORY.md, enabling recall via queries across the multi-layer PARA file organization.

No external dependencies are required. The PARA memory system operates entirely on file-based memory with paths relative to $AGENT_HOME, using YAML schemas and markdown files to manage knowledge graph, daily notes, and tacit knowledge layers.

Archive inactive items in the PARA knowledge graph during weekly synthesis. The system applies explicit decay and synthesis rules, including fact supersession and archival of inactive entities, while maintaining the rule to never delete existing durable facts.