memory git:20260911.c655850A

Immutable. This exact content is served forever at /api/v1/blob/6ac12abe5e43f3f2.

---
name: memory
description: 'Recall reviewed lessons or deliberately mine and curate experience. Use when: prior evidence can change an action, or learning is requested; no mandatory recall or lesson.'
practices:
- evidence-based-engineering
- continuous-learning
hexagonal_role: supporting
consumes: []
produces:
- applicable-context
- reviewed-topic-pages
- ranked-toil-evidence
context_rel: []
skill_api_version: 1
user-invocable: true
metadata:
  graph_root: true
  tier: execution
  dependencies: []
  capabilities: [recall_applicable_context, mine_supported_observations, curate_topic_pages, toil_mining]
  effects: [write_protected_drafts, update_authorized_topic_pages, write_requested_toil_report]
  canonical_status: canonical
  disposition: keep_off_path
output_contract: 'bounded applicable evidence or no-match; reviewed topic-page updates or no-change; ranked toil evidence with support, limits and unresolved gaps'
---

# Memory

Use maintained experience only when it helps an actual task. Memory is optional:
no mandatory recall at RPI entry, lesson at completion, worksheet, page quota or
background mining. A trivial edit can proceed directly to implementation.

## Choose one operation

| Need | Read on demand |
|---|---|
| An earlier constraint may change the next action | [Recall](references/recall.md) |
| Learn from a bounded set of episodes, failures or corrections | [Mine / learn](references/mine-learn.md) |
| Update, qualify, consolidate or retire a supported claim | [Curate / qualify / retire](references/curate.md) |
| Find repeated operational friction in supplied history | [Toil evidence](#toil-evidence) |

Mine/learn includes bounded verdicts, corrections and failed or harmful reuse;
it is not a required completion step. The optional
[OKF page profile](references/learn/okf-page-profile.md) checks structure only.
Do not load every operation reference just because Memory was selected.

## One authority per fact

BD or the caller's tracker owns work/status/dependencies/handoffs; Git owns
content and delivery history; native sessions and CASS own episode evidence.
The caller-selected reviewed external Markdown topic pages hold reusable claims,
not another work account. Search and update an existing topic page before making
a new one. Do not make one lesson file per session, copy a transcript lake, or
silently initialize a memory store. Source evidence is not policy.

A useful entry states **applicability, action, support, limits and invalidation**:
when it applies, what to do, the evidence, where it may fail, and what would
change or retire it. One incident supports a narrow observation, not a universal
rule. Stronger general rules need stronger independent/repeated evidence and
later reapplication. Keep rare useful constraints; age or low frequency alone
is no reason to delete them. Learning may simplify or remove rules.

## Access, storage and honest limits

Use only sources already authorized for the task, owner, model/provider and
exact destination. Read permission does not imply publication or Git storage.
This lean path supports **public or already-cleared trial inputs only**. Native
restricted-source enforcement is not implemented by this skill, a prompt, a
worktree or a same-user shell; do not retrieve restricted material through this
path. The existing `ao session read-source` supported profile does not grant
broader access or automatic transcript access. Unavailable and denied evidence
remain explicit gaps; do not fetch then redact.

Draft outside Git in caller-selected protected external staging. Obtain fresh
author-distinct factual-support and destination-disclosure review of the exact
payload before any Git object/index/stash or import. The caller selects storage;
missing routing does not authorize a workspace fallback. Preserve requested
legacy `.agents/` proof and unique evidence under owner policy. No blind TTL or
delete operation is part of Memory. Use the caller's supported protection and
recovery controls; labels and structural parsers do not prove isolation.
`docs/adr/ADR-0016-state-tiers.md` owns these boundaries in a repository
checkout; the operation references carry the installed rules.

Saved pages, retrieval counts and structural checks prove no benefit. Only later
work can demonstrate that reuse changed an action and helped its outcome; keep
failed, harmful and no-change results. Mining is separately budgeted off-path
and cannot delay finishing an already authorized change or alter its verdict.

## Toil evidence

Read only the explicitly supplied, authorized history within the stated window.
Preserve queries, filters and representative source references. Exclude machine
echoes and restored copies before clustering equivalent human actions. For
supplied Codex JSONL in a source checkout, the optional helper
`python3 scripts/toil-mining/recent_human.py --since <zoned-time> --until <zoned-time>
<explicit-session-paths>` extracts to stdout without discovering sessions or
reading attachments. Missing `client_id`, malformed records and exclusions stay
counted and disclosed; the extractor does not itself infer toil. It is not
bundled with standalone skill installs and adds no Python runtime dependency
to ordinary Memory use.

Report frequency, observed elapsed/token cost and failure or correction rate
separately. A recurring-toil claim needs three resolvable occurrences; smaller
groups remain tentative with their actual count. For a composite ranking, show
the measured inputs and formula; missing factors remain unmeasured, never an
invented average. Rank by demonstrated burden, not frequency or salience alone.
Each candidate includes clustering confidence, representative evidence, limits
and the smallest plausible automation shape. Separate observations from advice.

Return the ranked evidence inline by default, with checked/not-checked sources.
Only write a report when requested, using the authorized destination under the
storage rules above. Mining creates no tracker items, automations, ownership or
queue. A packaging request can use [Skill Builder](../skill-builder/SKILL.md);
evidence alone grants no authority to adopt a rule or schedule a job.

## Prompt

```text
Use Memory recall for this parser change. Search the caller-selected reviewed
external topic pages for an applicable constraint. Return only evidence that
changes the next check, or no-match; do not mine or save a new lesson.
```

## It's working if

A small task skips unnecessary recall. A matching narrow claim changes an actual
check without expanding its limits. Mining includes failures and corrections,
can end in no-change, and curation updates an existing topic page after exact
review. A stored page is never reported as a measured improvement.