> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rubixkube.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# The Memory Engine

> Private, compounding memory for your infrastructure. Every incident, RCA, and correction stays in your workspace and sharpens the next investigation.

Most infrastructure tools see your stack for the first time every time you log in. RubixKube remembers. The Memory Engine is what turns each incident into lasting knowledge your team and your agents can lean on.

It is private to your workspace, not shared across tenants, and gets sharper the longer it runs.

<Info>
  The Memory Engine powers the "eternal context" idea on the [RubixKube homepage](https://rubixkube.ai). Every signal, session, and resolution builds a deeper model of your system. That model belongs to you.
</Info>

## What the Memory Engine stores

<CardGroup cols={2}>
  <Card title="Incident resolutions" icon="file-circle-check">
    Every RCA report, the action that resolved it, and the verification outcome.
  </Card>

  <Card title="Operator context" icon="user-pen">
    Short notes operators add on resolution ("peak traffic repeats every Tuesday"). These are gold for future matches.
  </Card>

  <Card title="Chat sessions" icon="comments">
    Investigation threads, the questions asked, and which answers proved useful.
  </Card>

  <Card title="Graph deltas" icon="diagram-project">
    Topology changes over time. What services existed when, and what depended on what.
  </Card>

  <Card title="Rejections" icon="circle-xmark">
    Which recommendations your team turned down, and why. The system learns what not to suggest.
  </Card>

  <Card title="Policies" icon="shield-halved">
    Guardian decisions and their outcomes, so policy drift stays measurable.
  </Card>
</CardGroup>

## Why memory compounds

Every incident produces new connections in the graph. Three compounding effects are worth naming explicitly.

<Steps titleSize="h3">
  <Step title="Pattern recognition sharpens">
    The second time a similar signal shape appears, the RCA Pipeline starts with the previous causal chain as a hypothesis. Investigation time drops.
  </Step>

  <Step title="Recommendation quality rises">
    Rejected recommendations are weighted down. Applied-and-verified recommendations are weighted up. Your team's style shapes the defaults.
  </Step>

  <Step title="Context survives staff turnover">
    Tribal knowledge gets written into the memory instead of trapped in one engineer's head. When they move on, the context stays.
  </Step>
</Steps>

## A concrete example

An OOMKilled event in `payments-api`. First time RubixKube sees it, the RCA walks the full causal chain from scratch: memory curves, traffic patterns, recent deploys, code changes. Ten minutes of signal correlation.

Ninety days later, the same shape appears in a different namespace. The Memory Engine surfaces the original RCA, the fix that worked, and the operator note ("raise the limit from 512Mi to 1Gi, campaign traffic is bursty"). Investigation time drops from ten minutes to thirty seconds. Action is approved, verification lands inside the next stabilisation window.

The second incident took less effort than the first. The third takes less than the second. That is the compounding.

## Privacy and tenancy

<AccordionGroup>
  <Accordion title="Your memory is yours" icon="lock">
    The Memory Engine is scoped to your workspace. Nothing is shared across tenants. There is no cross-pollination of operator notes or incident history between customers.
  </Accordion>

  <Accordion title="Retention is plan-driven" icon="clock">
    Free tier keeps 7 days of history, Business keeps 30, Enterprise is unlimited. You can export or delete at any time.
  </Accordion>

  <Accordion title="Sensitive content is scoped" icon="eye-slash">
    Signals that contain secrets or personal data can be excluded from memory by rule. The Observer supports per-environment redaction.
  </Accordion>

  <Accordion title="Export when you want" icon="file-export">
    RCAs, sessions, and resolution notes export as Markdown or JSON. The graph itself exports as a structured dump for your archive.
  </Accordion>
</AccordionGroup>

## How to get the most out of memory

Small habits make the memory far more useful.

<CardGroup cols={2}>
  <Card title="Write short resolution notes" icon="pen">
    One or two sentences on what really worked, why it worked, and any context that would not be obvious to a newcomer.
  </Card>

  <Card title="Reject politely" icon="circle-xmark">
    When a recommendation is wrong, reject with a reason. The memory uses the reason to tune future suggestions.
  </Card>

  <Card title="Rename recurring incidents" icon="tag">
    Give repeating issues a clear name ("campaign-tuesday-memory-spike"). Matching surfaces faster.
  </Card>

  <Card title="Link to runbooks" icon="link">
    Attach links to internal runbooks on the RCA. Next incident of the same shape shows them automatically.
  </Card>
</CardGroup>

## Common questions

<AccordionGroup>
  <Accordion title="Is the Memory Engine an embedding store?">
    It uses embeddings under the hood, plus a graph model that tracks causal relationships and operator feedback. The two stay in sync, so similarity search and relationship queries both work against the same underlying data.
  </Accordion>

  <Accordion title="Can I query the memory directly?">
    Yes, through Chat. Questions like "have we seen this before" or "what did we do last time X happened" are first-class. The CLI supports the same.
  </Accordion>

  <Accordion title="How does the Memory Engine handle old infrastructure that no longer exists?">
    Decommissioned resources fall out of the active Knowledge Graph but stay in memory for retention purposes. Historical RCAs still reference them correctly, so post-mortems of past incidents do not break.
  </Accordion>

  <Accordion title="Does memory help across environments?">
    Yes. If a pattern learned on staging applies to production, the memory surfaces it. If a pattern from one AWS account applies to another, the same holds. Scoping stays inside your workspace.
  </Accordion>
</AccordionGroup>

## Related concepts

<CardGroup cols={2}>
  <Card title="Knowledge Graph" icon="diagram-project" href="/concepts/knowledge-graph">
    The live model of your stack that the Memory Engine references.
  </Card>

  <Card title="Root Cause Analysis" icon="magnifying-glass" href="/concepts/root-cause-analysis">
    How RCAs leverage prior art from memory.
  </Card>
</CardGroup>
