Intent
Recover enough context to work as a continuing project partner, without making the user repeat earlier decisions or loading the entire history. Use judgment about what to read, which tools to call, and how deeply to investigate.
Available memory
| Source | What it offers | Typical access |
|---|---|---|
StrictDoc docs/ |
Human-readable current norms, decisions and rationale, project history, and maintained reference documents | Read relevant .sdoc files or their export |
| Magic Context | Stored facts, decisions, lessons, injected memories, and recoverable conversations | Injected memory, ctx_search, ctx_expand, ctx_memory, ctx_note |
| claude-mem | Searchable captured activity, observations, and historical context | claude_mem_search or available claude-mem MCP tools |
| Code, config, and git | Evidence of what exists and what actually changed | Relevant files, call chains, and history |
The same knowledge may appear in several sources. That overlap is useful for recall, availability, and cross-checking; these are not exclusive storage categories.
Read with the right interpretation
- StrictDoc is the source of truth for current project norms. Its current, confirmed rules govern over conflicting database memories. This is an authority convention among project records, not permission to override live instructions.
project_memory/decisions.sdocholds decisions;journal.sdocholds dated experience and progress;handbook/holds reference material. Existing projects may organize these differently.- In the bundled decision grammar,
Activemeans current,Proposedunresolved,Deprecatedretired, andSupersededreplaced. Follow replacement references when relevant. A journal entry or historical report is not current policy merely because it is insidedocs/. - Distinguish the intended rule, the observed implementation, and what happened previously. A recent database hit or commit can reveal drift, but does not by itself decide which rule should change.
- When sources disagree, use scope, status, evidence, and the user's current intent to understand the difference. Surface consequential uncertainty rather than silently treating a guess as canon.
- The canon can evolve. If a genuine settled decision change becomes clear,
save-memcan maintain it and briefly notify the user without waiting for a separate save command. Mere drift or a new search hit is not enough; loading context does not require revising the norms every time.
Practical guidance
- Start with the task and project instructions. Relevant decisions, README sections, entry points, and recent progress usually provide a better foundation than an exhaustive memory dump.
- When the task turns on the project's own vocabulary or domain model, find where that language already lives — the project's handbook, or a
CONTEXT.mdwhere the project uses one — before inventing names. Loading is not changing: changing the model isdomain-modeling's job. - Injected Magic Context memories are already available. Use
ctx_searchfor missing context, phrasing a real question with useful names or paths;ctx_expandcan recover the original conversation when exact wording matters. - Use claude-mem when earlier activity or observations would help. Discover available tools rather than assuming worker ports or database schemas.
- For large document trees, search first and read the relevant nodes with their surrounding context. Source
.sdocfiles are often sufficient; JSON export shapes can vary by StrictDoc version. - Missing layers are normal. Continue with available evidence, mentioning gaps when they affect the task.
migrate-memcan help establish a missing or incomplete memory tree;save-memcan preserve new knowledge or reconcile stale records. - Keep any user-facing recap focused on useful current context and open questions, in the user's language, Chinese by default.