Local, git-versioned memory for AI coding agents. No RAG, no Docker, no external service. Capture, compile, recall over a local LLM wiki with on-device embeddings and an MCP server.
Cursor rule Cursor
Debug llm-wiki-memory capture/recall — flush breadcrumbs, daily-vs-compile lag, failed-distill stash recovery, embedding cache, hook wiring. Use when memory didn't capture, doesn't recall, or a hook/cron looks broken.
Cursor rule Cursor
Defensive invariants — when a check may be deleted — Deleting a defensive check because a proof says it cannot fire is the most expensive class of mistake made in this codebase. Canonical file is .agents/rules/defensive-invariants.md.
Cursor rule Cursor
Follow the canonical rule (edit that file, never this shadow).
Cursor rule Cursor
README and docs style for llm-wiki-memory — install-first structure, plain-English jargon, vertical Mermaid with quoted labels, badge rules. Canonical file is .agents/rules/docs-style.md.
Cursor rule Cursor
Live-runtime safety — the tree you are editing IS the running system — .llm-wiki-memory/src is not a checkout that gets built and deployed. Canonical file is .agents/rules/live-runtime-safety.md.
Cursor rule Cursor
Module-state ownership & caches built from hot-reloading settings — How mutable module-scope state is owned here, and what caching anything derived from settings() obliges. Canonical file is .agents/rules/module-state-ownership.md.
Cursor rule Cursor
Authoring a release migration (llm-wiki-memory itself) — This rule governs developing llm-wiki-memory itself. Canonical file is .agents/rules/release-migrations-authoring.md.
Cursor rule Cursor
Run the llm-wiki-memory test suite without filling /tmp — sweep stale lwm- workspaces, iterate on single files, run npm test once. Use when running or debugging tests in this repo.
Cursor rule Cursor
Self-observability (watch llm-wiki-memory while you work; offer fixes) — This rule applies to every AI agent (Claude Code, Cursor, Codex, generic MCP clients) working Canonical file is .agents/rules/self-observability.md.
Cursor rule Cursor
Testing rules for llm-wiki-memory — node:test harness conventions, mock-provider seams, the /tmp/lwm- leak trap. Canonical file is .agents/rules/testing.md.
Cursor rule Cursor
Skill: triage review findings without acting on false positives — Full criteria for the guard-deletion case below: .agents/rules/defensive-invariants.md. Canonical file is .agents/skills/triage-review-findings.md.
Cursor rule Cursor
Verification completeness — What "verified" and "green" are allowed to mean in this repo. Canonical file is .agents/rules/verification-completeness.md.
Cursor rule Cursor
Skill: verify a change to the live engine tree — /.llm-wiki-memory/src runs LIVE — the MCP server, the Claude Code hook workers, and cron import it as you edit. Canonical file is .agents/skills/verify-live-change.md.
Cursor rule Cursor
Author an idempotent, state-detecting migration under scripts/migrations/ for a breaking llm-wiki-memory change. Use when shipping a breaking change to the engine, or when asked to write a migration / upgrade path. Replaces the retired release-runbook flow.