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

  1. Separate durable facts. Keep stable preferences, environment details, and reusable conventions.
  2. Avoid stale progress. Do not store completed ticket numbers, old statuses, or short-lived task reminders.
  3. Use files for bulk knowledge. Long references belong in docs, JSON, databases, or source files.
  4. Keep secrets out. Store credentials in secret managers or local environment files, never in chat memory.
  5. 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