project-memorylisted

# Project Memory Project memory is durable knowledge that outlives any single run. It lives in the repo as plain markdown, so it travels with the project and any runtime can read it. Store layout: `.megapowers/memory/` holds `INDEX.md`, one line per memory, plus one fact per file at `<slug>.md` with frontmatter fields `name`, `title`, `hook`, and `type` (one of `decision`, `constraint`, `preference`, `gotcha`, `reference`) and the fact as the body. Link related memories with `[[slug]]`. ## What earns a memory Save what is durable and not otherwise recoverable: a non-obvious decision and its rationale, a constraint invisible in the code, a stated user preference, a hard-won gotcha, a pointer to an external resource. Don't save or duplicate what code, git history, the README, canonical `CONTEXT.md` (or the repository-named equivalent), or accepted ADRs already record, or anything true only for the current task; if asked to remember something derivable, save the non-obvious part instead. Hygiene: one fact per file; update the existing file rather than duplicate; delete a memory that turns out to be wrong; convert relative dates to absolute. ## Helpers ```bash scripts/mem-add <slug> --title T --hook H [--type decision|constraint|preference|gotcha|reference] [--update] # body read from stdin; writes .megapowers/memory/<slug>.md and regenerates # the index. refuses to overwrite an existing slug unless --update. scripts/mem-index # rebuild INDEX.md (a file mi