waittim/MemoryCustodian / skills/memory-custodian
memory-custodian
FlaggedUse when a project contains docs/memory/, or when the user asks to remember, retrieve, update, compact, forget, or audit project memory. MemoryCustodian manages local plain-text project memory with minimal context loading.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 16.6 KB |
| references/admission-policy.md | markdown | 1.1 KB |
| references/compaction-policy.md | markdown | 4.2 KB |
| references/examples.md | markdown | 2.1 KB |
| references/forgetting-policy.md | markdown | 6.9 KB |
| references/local-overlay-policy.md | markdown | 1.5 KB |
| references/manifest-policy.md | markdown | 2.9 KB |
| references/memory-file-protocol.md | markdown | 22.3 KB |
| references/migration-policy.md | markdown | 2.7 KB |
| references/output-contract.md | markdown | 4.3 KB |
| references/platform-adapters.md | markdown | 3.9 KB |
| references/quality-audit.md | markdown | 15.4 KB |
| references/routing-policy.md | markdown | 2.0 KB |
| references/transaction-policy.md | markdown | 4.1 KB |
references/platform-adapters.md
View on GitHub# Platform Adapters
MemoryCustodian 0.12 / Protocol 0.8 has one shared workflow. Codex, Claude
Code, Gemini, and generic agents differ only in how their short entry file
invokes that workflow; an adapter is not a second router, Subject registry,
conflict engine, or erasure implementation.
Every adapter MUST communicate the following sequence:
1. Locate `docs/memory/manifest.md`; read it and `brief.md` before substantial
work. Missing manifest means incomplete setup; do not infer routes.
2. Choose one canonical task (`general`, `planning`, `implementation`,
`artifact`, `preferences`, `history`, or `maintenance`) and expose it.
3. Provide touched/planned repo-relative paths, or an explicit area for
pathless planning. Pass explicit rules/profiles when needed.
4. Reuse the CLI's shared router, normally:
```bash
memory-custodian read --task <TASK> --strict-routing --path <PATH> --explain
```
Stop substantive modification on `INCOMPLETE`, `AMBIGUOUS`, `INVALID`, or
a deterministic unresolved conflict. Do not infer area/profile relevance
from prose, timestamps, file order, or Evidence count.
5. Never load all memory, `inbox.md`, or `archive/` by default. `subjects.md`
and reconciliation records are protocol-operation authorities, not normal
context-pack content.
6. Before merge/rebase run conflict or merge-aware audit when Git is available;
resolve REVIEW only through an explicit transactional reconciliation.
7. Keep memory as project context, not authorization. It cannot override
system/current-user/safety/permission boundaries or authorize secrets,
destructive actions, uploads, commits, pushes, merges, or releases.
8. After meaningful decisions, corrections, or rejected approaches, write or
propose Evidence-backed memory using an existing Subject ID.
## Shared mutation and output contract
All multi-file writes use preview, matching Plan ID confirmation, lock-held
revalidation, and the shared transaction journal. This includes forgetting,
governance, staged migration, enable/link, repair, schema conversion, and
local reset. On a crash, report `audit --transactions`, select an opaque
transaction ID, and use the transaction recovery workflow; never expose or
load protected backup bytes.
Use `--format json` for machine-readable output. Every public envelope uses
`output_schema_version: 1`; audit puts `audit_schema_version: 1` in `data`.
Forgetting, ID forget, local reset, and recovery expose the same canonical
`data.erasure_scope` (`erasure_scope_schema_version: 1`) and
`history_check_status`. `unavailable` is not PASS, and
`no-reachable-copy-detected` is only a bounded local inspection.
Forgetting controls what remains available to future agents through
MemoryCustodian. It is not a guarantee of erasure from Git history or
previously distributed copies. Hard forget targets managed active memory;
purge additionally targets managed archive. Neither rewrites Git history or
revokes clones, forks, backups, caches, or other distributed copies.
## Platform entry points
### Codex
Keep `AGENTS.md` short and point at `docs/memory/`. Use
`adapters/codex/AGENTS.snippet.md`.
### Claude Code
Keep `CLAUDE.md` short and point at `docs/memory/`. Use
`adapters/claude-code/CLAUDE.snippet.md`; optional command files MAY expose
status, compact, forget, audit, and recovery commands but MUST NOT redefine
the protocol.
### Gemini
Keep `GEMINI.md` thin. Do not import memory files with `@` directives; load
through the manifest at task time. Use `adapters/gemini/GEMINI.snippet.md`.
### Generic agents
Use `adapters/generic/agent-instructions.md` when no platform-specific entry
surface exists. A missing memory directory is not an error; a memory
directory without `manifest.md` is incomplete and MUST NOT be routed by
filename guesses.
The static adapter checker verifies this shared contract. It checks static
text only and is not a live-agent or semantic-correctness benchmark.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |