Skip to content

waittim/MemoryCustodian / skills/memory-custodian

memory-custodian

Flagged

Use 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.

references/migration-policy.md

View on GitHub
# Protocol 0.8 Staged Migration Policy

Package 0.12 can read Protocol 0.5, 0.6, and 0.7 projects, including Entry
schema 1 and 2 legacy inputs, while writing only the selected source grammar
until staged migration is complete. Source `protocol_version` and
`entry_schema_version` decide parsing first: schema 1 treats a literal
`memory-custodian-body-v1` string as body text; schema 2/3 decode the explicit
wrapper. A newer or malformed protocol is rejected; migration never silently
downgrades metadata.

Migration has three mutually exclusive stages. Each invocation defaults to a
preview. Applying a preview requires its own `--confirm-plan` and its own
transaction; Prepare and Finalize never share a Plan ID or journal.

```bash
memory-custodian migrate --prepare
memory-custodian migrate --prepare --apply --confirm-plan <PREPARE_PLAN>
memory-custodian migrate --canonicalize
memory-custodian migrate --canonicalize --apply --confirm-plan <CANONICALIZE_PLAN>
memory-custodian migrate --finalize
memory-custodian migrate --finalize --apply --confirm-plan <FINALIZE_PLAN>
```

## Prepare

Prepare records source protocol/schema, project/bootstrap identity, normalized
root, bound local-overlay snapshot, and source digests in protected
repo-external migration state. It leaves shared protocol metadata unchanged.
It MAY perform only mechanically provable transformations and emits a
per-entry checklist for Evidence, Subject, Facet, relations, and
canonicalization blockers. It never invents Evidence, Subject equivalence,
Facet assignments, exceptions, or reconciliations.

## Manual interval and canonicalize

Canonicalize is repeatable and preview-first. It MAY convert an unambiguous
legacy unit but requires explicit type, title, Evidence, Scope, Subject, and
Facet for semantic promotion. Ambiguous units remain unchanged and block
apply. Target-only Entry schema 3 metadata is held in protected migration
state until Finalize; a bound local overlay uses the shared Entry schema and
participates in the same eventual transition.

## Finalize

Finalize creates a fresh Plan ID and transaction, revalidates the prepare
binding and current source files, requires canonical active entries, complete
Subject/Facet/relations, and no audit ERROR/BLOCKER or canonicalization
blocker. It writes target-only schema 3 rewrites and bound local rewrites in
one transaction, commits `protocol_version: 0.8` and `entry_schema_version: 3`
last, then removes migration state. A failure is detected by the transaction
audit and is completed or rolled back only through the recovery policy.

Migration is syntax-aware and deterministic; it does not infer semantics from
timestamps, file order, prose similarity, or Evidence counts, and it is not a
promise of semantic correctness.
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall