Shipping the memory graph

Vector search forgets. It retrieves chunks that look similar, not code that is connected. Six months into the alpha, we kept watching Rafan miss the middleware that wrapped the handler it was editing — because the names didn’t overlap.

The memory graph replaces similarity with structure: symbols, imports, call sites and ownership, rebuilt incrementally on every commit. Retrieval walks the graph the way a senior engineer walks the codebase.

Project memory stays plain markdown in .rafan/memory — conventions, decisions, glossary. Reviewable, versioned, portable. The graph is the index; the markdown is the judgment.

Questions or corrections? Bring them to the community thread — we read every one.

— The Rafan team