memory-flywheellisted

# memory-flywheel A per-project, cross-session memory built as an iterating **data flywheel** (WS-B; overhaul tasks 3/4/5). It complements the raw JSONL logs and the compaction-summary memory: JSONL is too bulky to load whole, and `/compact` is **lossy** (it keeps file states + decisions but drops intermediate reasoning and rejected approaches — verified). The flywheel keeps the **verbatim** detail in grep-native files with a coarse→fine index, so nothing important is silently lost and recall is cheap. **Design (see `docs/strategy/agent-harness-overhaul-2026-07-09/00-research.md` §B):** integrative of Zep's episodic→semantic tiers, MemWalker's descend-a-summary-tree, A-MEM's keyword/graph overlay, and Anthropic's memory-tool + Skills progressive disclosure. The novel niche is a *coding-agent, per-project, grep-native file* memory combining verbatim leaves + control metadata + a descended coarse→fine index + keyword recall. ## Layout (under `--root`, default `.agent-memory/`) ``` <root>/<project>/ rounds/NNNN-<kind>.md one file per round: frontmatter (id, kind, title, ts, keywords) + VERBATIM body INDEX.md coarse layer — a table of every round; READ THIS FIRST ``` ## The loop (each substantive round) 1. **Record** the round verbatim (raw input/output/decision), tagged with a kind + keywords: `python3 scripts/mem.py record --project P --kind design --title "…" --keywords a,b < body` (auto-refreshes `INDEX.md`.) 2. **Recall** before acting, p