Building a Private Memory Layer

Memory is most useful when it prevents repeated instructions. It is dangerous when it becomes a junk drawer for stale task progress or private secrets.

When this matters

This page is for operators who want Rocky to produce usable work without turning the system into a mystery box. Use it when you need a practical path, a clear verification step, and a boundary between suggestion and action.

The operating pattern

  • Separate durable facts. Keep stable preferences, environment details, and reusable conventions.
  • Avoid stale progress. Do not store completed ticket numbers, old statuses, or short-lived task reminders.
  • Use files for bulk knowledge. Long references belong in docs, JSON, databases, or source files.
  • Keep secrets out. Store credentials in secret managers or local environment files, never in chat memory.
  • Review periodically. Remove facts that are old, misleading, or too broad.

Pre-flight checklist

  • The fact will still matter next month
  • It is short enough to be injected safely
  • It does not contain a password/token/key
  • It does not describe temporary progress
  • It helps Rocky avoid asking again

Common failure modes

  • Over-memory: Too many memories reduce relevance and can override the current request.
  • Secret leakage: Memory is not a vault.
  • Imperative phrasing: Store facts, not commands that may be misread later.

Verification

A page is not done because it was drafted. Verify the source, run the workflow, inspect the output, and record what changed. If a step touches money, customers, accounts, permissions, or private data, keep it behind an explicit human approval gate.

Related next steps