Index¶
Catalog of all wiki pages. One line each: link + summary. Updated on every ingest. Read this first when answering questions from the wiki.
Topics¶
Grouped by domain folder under topics/. A page has exactly one physical home;
its cross-cutting axes live in the frontmatter tags: and in each page's
## Related section.
AI & Knowledge Systems (ai/)¶
- ai-agent-architecture — the agent loop, memory, context engineering, MCP, sandboxes,
cost architecture.
#ai #guide - claude-code-memory-architecture — Claude Code auto memory (injected schema,
MEMORY.md index, no dedicated tools, recall with no retrieval engine) vs the API
memory_20250818tool; schema by convention vs enforcement.#ai #pkm #guide - agent-memory-at-scale — when file-and-index memory stops scaling (the index
breaks, not the storage), the three real triggers for a vector DB, and RAG as an
agent search tool. Flags a tension with ai-agent-architecture §6.4.
#ai #pkm #guide - ai-adoption-maturity-model — the five steps of org AI adoption (0 gated → 4
AI-native): the bottleneck that defines each step, the transition unlocks, and how
guardrails escalate in kind. Flags a tension with ai-agent-architecture §2.3 on
multi-agent.
#ai #devops #guide - llm-wiki-pattern — Karpathy's compile-don't-retrieve pattern: three layers
(immutable sources / LLM-owned wiki / the schema), three operations, index vs. log.
The pattern this vault implements — includes where
BRAIN.mddiverges from it.#ai #pkm #guide - okf-spec — Google Cloud's markdown + YAML-frontmatter spec for
agent-consumable knowledge: one required field, bundles as directory trees,
interoperability surface vs. content model. Tested against
agent-memory-at-scale's index-scaling argument.
#ai #pkm #data #guide - llms-txt-vs-robots-txt-vs-sitemap — three machine-readable files compared; the
publishing side of the context problem ai-agent-architecture §7 describes from
the agent's end.
#web #ai #guide
.NET (dotnet/)¶
- dotnet-microservices-auth-architecture — auth microservice with Identity Core,
plus integration testing strategy. The domain's straddle page: implementation here,
protocol in
security/.#dotnet #security #auth #testing #guide - api-rate-limiting-dotnet — fixed window, token bucket, DI integration.
#dotnet #guide - csharp-xsd-schema-tools — XSD tooling and code generation on Linux.
#dotnet #xml #guide - xml-transformation-framework — XPath / strongly-typed / hybrid XML mapping; consumes
what csharp-xsd-schema-tools generates.
#dotnet #xml #guide - tdd-ddd-from-the-ground-up — red-green-refactor, event storming, vertical slices
(Chris Simon).
#design #testing #dotnet #talk-notes
Security & Identity (security/)¶
- oauth-oidc-keycloak-architecture-guide — OAuth 2.0 / OIDC / Keycloak from first
principles: flows, tokens, BFF, multi-tenant access control.
#security #auth #guide - seven-cryptography-concepts — hashing, HMAC, symmetric/asymmetric, signing — the
primitives the guide above applies.
#security #talk-notes
Ops & Infrastructure (ops/)¶
- postgresql-backup-restore-docker — pg_dump/psql, dump formats, redirection.
#devops #docker #postgres #guide - odoo-filestore-backup-restore-docker — tar-based filestore backup via volume mounts;
the other half of a valid Odoo restore.
#devops #docker #guide - playwright-docker-verification — browser verification via Playwright in Docker, plus the
beginFrame + virtual-time recipe for deterministic video capture.
#tooling #testing #docker
Design & UX (design/)¶
- ux-psychology-principles — why interfaces work: perception, memory, interaction cost,
decisions, motivation, trust, each with its mechanism and an evidence grade
(replicated / contested / folklore), plus corrections to famous claims.
#design #ux #psychology #guide - dark-patterns — persuasion turned against the user: Brignull → Gray → Mathur
taxonomies, DSA Art. 25 and FTC anchors, and the three-check test (truthful framing,
symmetric exit, endorsement).
#design #ux #ethics #regulation #guide - ui-craft-rules — grid, palette, type, icons, dividers, CTAs, each tied to the
mechanism it serves; WCAG thresholds as the same mechanisms at their limit.
#design #ux #accessibility #guide
Entities¶
(none yet — see the growth frontier below)
Sources¶
- ux-psychology-research — Wim Suenens (with Claude), The psychology behind good app and UI design, Oct 18 2026. Primary-source research notes from the agent-plugins repo, every principle graded. → ux-psychology-principles, dark-patterns, ui-craft-rules
- steps-of-ai-adoption — Boris Cherny (Anthropic), Steps of AI Adoption, Jul 16 2026. Five-step org adoption ladder as a table; captured from a Claude artifact. → ai-adoption-maturity-model
- open-knowledge-format — Sam McVeety & Amir Hormati (Google Cloud), Introducing the Open Knowledge Format, Jun 12 2026. Structured capture (not verbatim) of the OKF v0.1 announcement. → okf-spec, agent-memory-at-scale
- llm-wiki-karpathy — Andrej Karpathy, LLM Wiki, Apr 2026. Verbatim capture of the gist body (comment thread not included). The founding document of this vault. → llm-wiki-pattern, agent-memory-at-scale, okf-spec
Provenance of the wiki pages above (updated 2026-07-20). The first bucket is exactly
the set of pages carrying a sources: frontmatter field, so it is mechanically checkable:
- Draws on a source in sources/: agent-memory-at-scale, ai-adoption-maturity-model,
dark-patterns, llm-wiki-pattern, okf-spec, ui-craft-rules,
ux-psychology-principles. (agent-memory-at-scale began as a
session synthesis and later took substantive content from two sources — the sources:
field records what fed a page, not where it started.)
- Filed back from a working session, no raw source: claude-code-memory-architecture.
- All others were authored by Wim in the obsidian-notes vault and migrated 2026-07-19.
Growth frontier¶
Wikilinks that exist in the pages above but have no page yet — each marks something worth writing, in the llm-wiki-pattern sense. All originate in ai-agent-architecture unless noted.
Entity candidates: [[LangChain]] · [[Model Context Protocol]] ·
[[Microsoft Agent Framework]] · [[OpenTelemetry]] · [[Google Cloud]] (from
okf-spec — deliberately not created 2026-07-20; one blog post is
thin grounds to open the entities section)
Also declined 2026-07-20: an [[Andrej Karpathy]] entity page, same reasoning as
[[Google Cloud]] — one gist is thin grounds. The entities section stays empty by
decision, not by neglect; revisit when a second source makes the same actor recur.
Topic candidates: [[ReAct]] · [[prompt injection]] · [[JSON Schema]]
(also in xml-transformation-framework)
Retired 2026-07-19: [[RAG]] and [[vector database]] — the useful knowledge
(when either is warranted, and how they fit an agent loop) is now written up in
agent-memory-at-scale. Dedicated stubs would only be generic explainers. The
bare wikilinks still appear in ai-agent-architecture and stay unresolved by
design; its Related-notes list points at the covering page instead.
Cross-links resolved¶
Closed 2026-09-06. The four clusters carried over from the old vault's Home.md
are now written as ## Related sections on the pages themselves, in both
directions: [[csharp-xsd-schema-tools]] ↔ [[xml-transformation-framework]]; the
identity stack ([[oauth-oidc-keycloak-architecture-guide]] ↔
[[dotnet-microservices-auth-architecture]] ↔ [[seven-cryptography-concepts]]);
[[ai-agent-architecture]] ↔ [[llms-txt-vs-robots-txt-vs-sitemap]]; and the
reciprocal on [[postgresql-backup-restore-docker]] ↔
[[odoo-filestore-backup-restore-docker]], which had only been one-way.
The same pass reached the nine pages migrated on 2026-07-19 that had no inbound link
from any page — their only reference had been their catalog line above. Every topic
page now has at least one ## Related edge.