index 90d69db..a6f5761 100644
@@ -1,3 +1,39 @@
-# architecture
+---
+title: Knowledge Publishing Architecture
+visibility: public
+---
-welcome to your wiki.
+# Knowledge Publishing Architecture
+
+A living knowledge base of design decisions, trade-offs, and architectural patterns for **ListHub** and **WikiHub** — two products that share DNA but optimize for different things.
+
+## What this is
+
+A Karpathy-style LLM wiki: a markdown knowledge base that grows over time as we make decisions, discover patterns, and learn from implementation.
+
+## Index
+
+### Architecture
+- [[beads-vs-wikihub-architecture]] — Steve Yegge's Beads (SQLite→JSONL) vs WikiHub (git→Postgres)
+- [[two-bare-repos-per-wiki]] — Authoritative + public mirror architecture
+- [[post-receive-vs-plumbing]] — No-loop sync invariant
+
+### Data Model
+- [[acl-codeowners-pattern]] — `.wikihub/acl` glob-based permissions
+- [[visibility-modes]] — The 8-mode vocabulary
+
+### ListHub Specific
+- [[listhub-db-git-mirror-pattern]] — DB source-of-truth + one-way per-user bare git mirrors
+
+### Open Questions
+- [[milkdown-editor]] — Rich editor choice
+- [[deployment-domain]] — wikihub.globalbr.ai? Separate Lightsail?
+- [[concurrent-edit-posture]] — Last-write-wins vs git-merge vs optimistic-lock
+- [[events-jsonl-scope]] — v1 or v2?
+
+## Products covered
+
+| Product | Stack | Live |
+|---------|-------|------|
+| **ListHub** | Flask + SQLite + Jinja | listhub.globalbr.ai |
+| **WikiHub** | Flask + Postgres + Jinja + bare git | wikihub.globalbr.ai |
\ No newline at end of file