This repository has three kinds of documentation. Keep them separate so the current product rules stay clear.
- Memory Policy: cross-project rules for Memory Substrate behavior and MCP tool semantics.
- Agent Memory MCP Usage: how agents and humans should call the four MCP tools.
- MCP API Reference: supported modes, required call shape, and examples.
- Project Development Policy: development strategy for this repository only.
- Current Todo: active execution queue and near-term priorities.
- Context Substrate Memory Core Research
- Memory Backend Library Spike
- Semantic Retrieval And Reasoner Evaluation
- Semantic Retrieval Spike
- Source Extraction Dependency Decision
- Graph Health Dependency Decision
- MemPalace Design Review
- Candidate Crystallization Dogfood
- Source Notes: imported source material such as
argue.mdandllmwiki.md.
Research notes are evidence and reasoning history. They are not the current product contract unless a current canonical doc cites a decision from them.
Specs and plans capture design decisions and implementation slices. Historical wiki-centered specs remain useful as archaeology, but current work should follow the memory-substrate policy and project development policy.
- Keep
README.mdshort and navigational. - Put MCP parameter details in
mcp-api-reference.md. - Put cross-project memory rules in
memory-policy.md. - Put repository-specific strategy in
project-development-policy.md. - Update
todo.mdwhenever active priorities change. - Add a historical note instead of deleting old design docs unless the file is actively misleading and no longer useful.