memory-steward

Installation
SKILL.md

Memory steward

Keeps <repo-root>/MEMORY.md healthy. Workspace CONTEXT.md and docs/adr/ stay at <artifacts-root>; this skill does not move domain terms into MEMORY.

Resolve paths

  1. Active repo root — git root for cwd, or Project Matrix Path for the project being edited. Never use the meta-workspace folder (path: ".") for MEMORY.md.
  2. <artifacts-root> — directory with *.code-workspace, else CONTEXT-MAP context root, else single repo root. ADRs: <artifacts-root>/docs/adr/.

If MEMORY.md is missing at active repo root and recall would help, scaffold a minimal index-only MEMORY.md there (≤~300 lines, one bullet per durable fact, no secrets).

Session start (light pass)

Run automatically at session start after reading repo MEMORY.md (mandated in AGENTS.md). Keep output short.

  1. Count lines in active repo MEMORY.md (0 if missing).
  2. Scan ## Promotion queue and ## Decisions (short) for ADR-NNNN: tags.
  3. If lines > ~300 OR promotion queue non-empty OR user’s last message implies memory work → note that full pass is advised; run full pass only if queue is non-empty or lines > 300.
  4. Otherwise: one-line status only (e.g. Memory: api-service/MEMORY.md, 42 lines, queue empty). No file writes.
Installs
4
First Seen
May 28, 2026
memory-steward — devarfeen/agent-skills-kit