The contract-first knowledge graph
The always-on you has to stay small, but you still want the AI to know a lot. The
fix is to keep deep knowledge out of every-turn context and put it in a graph the AI
walks on demand. In MemMini that graph is wiki/ — plain markdown, no vectors,
no database, just files with frontmatter and typed links plus a deterministic
registry.
Typed edges, not “see also”
Section titled “Typed edges, not “see also””Each page links to others under typed section headings that name the kind of relationship, and the link’s anchor text carries the reason to follow it:
| Heading | Means |
|---|---|
## Depends on | this needs that to exist or stay healthy |
## Unblocks | this enables that to proceed (the mirror of Depends-on) |
## Contrasts with | a comparable alternative with different tradeoffs |
## Related | weak association — not a dependency |
[skin turns red when ripe] beats [see also: ripeness]. A reasoned anchor tells
the model when to traverse; “see also” tells it nothing.
Every dependency names a contract
Section titled “Every dependency names a contract”The load-bearing rule: a ## Depends on edge must name the contract it rides on
— the protocol, format, interface, schema, SLA, or convention that lets the two
sides connect. If you can’t name the contract, it isn’t a dependency; it’s a
## Related. Contracts are first-class because every real dependency rides on one,
and naming them is what makes parallel work possible: two sides can build
independently against a stable agreement.
The graph stays honest by construction: every Depends on has a mirrored Unblocks
on the other page, and edges without a contract get flagged. Distillation enforces
these invariants so the graph doesn’t quietly corrupt as it grows.
Retrieved in tiers
Section titled “Retrieved in tiers”The AI doesn’t load the whole graph. It uses three tiers:
- a one-line habit rule in the injected context — on a factual claim, consult the wiki first;
wiki/INDEX.mdhubs (trigger phrase → subdirectory) compiled into context;- on capable platforms, tools that read a page by slug or walk its typed edges N hops; elsewhere, paste or a compiled domain bundle.
Go deeper
Section titled “Go deeper”Canonical schema — frontmatter fields, entity and contract types, dependency kinds,
critical-path markers:
wiki/README.md.
See also Wiki schema reference.