Foundations¶
This tab is the conceptual core of the guide. By the end of it, you should be able to explain to a colleague what SiftCoder does, why it does it that way, and what the consequences are when something goes wrong.
The chapters are ordered from most to least essential. If you only have time for two, read Mental model and Architecture overview. The rest fill in detail.
- Mental model — the four moving parts and how they relate.
- Architecture overview — the components on disk, the processes at runtime, the data flowing between them.
- The memory model — events, summaries, embeddings, sessions, and how they fit in SQLite.
- Retrieval and ranking — how a query becomes a list of relevant memories.
- Namespaces and workspaces — what isolation looks like and how it's keyed.
- Backends — Ollama, Anthropic, deterministic, sampling. When each one runs.
- Hooks lifecycle — what fires when, and how the hooks integrate with Claude Code.