deathbyknowledge/gsv/memory

Manage Personal Memory

Memory belongs to the human, not to an individual agent. Every agent working for the same user reads and writes the same two layers:

• The personal wiki contains durable information that is searched and loaded when relevant.
• The owner's context.d/10-personal.md contains a very small set of stable facts and preferences that should affect nearly every interaction. It appears under the editable <user> context root in the prompt; do not confuse it with the current agent's ~/context.d/.

The Kernel responsibility ledger is working state, not personal memory. Do not copy unresolved responsibilities into the wiki merely because they exist. Record an outcome later only when it is useful history.

Decide When to Read

Retrieve memory before asking, recommending, or acting when the correct interpretation or outcome could depend on personal history that is not already in the current context. Examples include an ambiguous person or project name, the user's usual grocery order, travel details, prior decisions, recurring preferences, and where the user normally keeps something.

Do not search memory for self-contained questions whose answer cannot depend on the user. Do not search merely to prove that memory exists.

Search narrowly before opening broad pages:

wiki search <query> --prefix personal

Use wiki info personal when the page location is unknown. Once a relevant page is known, use normal filesystem tools to read its Markdown under the path reported by wiki info.

Decide When to Write

Write immediately when the user explicitly says to remember an unambiguous fact or corrects an existing fact. Also write a concrete, stable fact or preference that the user states explicitly when it will improve future help.

When work reveals durable context about a person or relationship, preserve it promptly even if the user did not explicitly ask you to remember it. This includes identity, alternate names or handles, how the person relates to the user, ongoing shared projects, and meaningful interaction outcomes. Do not wait for compaction or a later request to make the information durable. Record inferred context as an inference rather than omitting it, and include a date or source when it will help resolve future ambiguity.

Search and merge before writing when the fact may already exist, refers to an ambiguous person or project, supersedes older information, or belongs on more than one existing page. Ship can perform short lookups and edits directly; delegate when the work benefits from parallel execution, separate context, or lengthy investigation.

Append a journal entry for a meaningful event or outcome whose chronology may matter later. Use ISO dates:

pages/journal/YYYY/MM/YYYY-MM-DD.md

Recover Missing Memory from Process History

Process history is lossless recovery evidence, not the primary memory system. Search the Personal wiki first. If relevant memory is missing and earlier Process work likely contains the answer, inspect that history and then repair the wiki with the durable facts you recover.

For compacted history belonging to a visible Process, prefer the structured Process interface:

proc segments --pid <pid>
proc segment <segment-id> --pid <pid> --json

Reset and terminated Process transcripts are stored as gzipped JSONL under the run-as agent's home. Locate candidate archives and stream them through zcat; do not try to read compressed bytes as text or modify the immutable archive:

find "$HOME/processes" -name '*.jsonl.gz'
zcat "$HOME/processes/<pid>/history/<archive>.jsonl.gz" \
  | jq -r '[.ts, .role, .content] | @tsv' \
  | rg -i '<term>'

Search narrowly by likely Process or date when possible. Once the missing context is recovered, merge the useful facts into the appropriate Personal wiki page. Do not copy raw transcripts, reasoning, or tool noise into memory.

Organize the Wiki

Search before adding duplicate information. Read a page before editing it. Keep index.md as an orientation page and use inbox/ only for information that genuinely cannot yet be placed. Promote durable information into topical pages such as:

• pages/people/
• pages/projects/
• pages/preferences/
• pages/decisions/
• pages/routines/
• pages/places/
• pages/concepts/

When a name is ambiguous, make the short-name page a disambiguation page that points to specific pages. Replace superseded facts rather than accumulating contradictions. Prefer concise facts and useful context over prose about the act of remembering.

Use man wiki for exact wiki syntax and general wiki workflows.

Maintain Standing Memory

Edit the owner's context.d/10-personal.md only for explicit, stable facts or preferences that should be present in almost every interaction. Keep the file small, preserve its purpose statement, and replace corrected facts.

Unresolved work belongs in the r12y responsibility ledger. Do not duplicate it in standing context or the wiki.