Replace static CLAUDE.md with LLM wiki schema

[taddyb]

Summary

• Replaces the 400-line static architecture doc in CLAUDE.md with a 30-line wiki-schema that instructs LLM agents to maintain a persistent, compounding wiki/ directory
• Implements the LLM Wiki pattern (Karpathy, 2025): instead of re-deriving codebase knowledge from scratch every session, agents incrementally build and maintain interlinked markdown pages with an index and append-only log
• The previous architecture documentation will live in the wiki itself, maintained and kept current by the LLM rather than manually

Why this change?

The old CLAUDE.md was a static snapshot that drifted out of date with every PR. The wiki pattern solves this: the LLM owns the documentation layer and updates it as code changes — cross-references, module maps, test counts, and API surfaces stay current because maintenance cost is near zero.

What the new CLAUDE.md defines

• Wiki operations: when to update pages (after code changes, before compaction, on query)
• File conventions: wiki/index.md as a one-line catalog, wiki/log.md as an append-only changelog
• Page style: module tables, key concepts in prose, test coverage sections
• Lint checklist: ensures every src/ package has a wiki page, no stale references, cross-references resolve

Test plan

• CLAUDE.md passes pre-commit hooks (ruff, trailing whitespace, end-of-file)
• Verify LLM agents (Claude Code, Copilot, Cursor) correctly parse the wiki schema and maintain wiki/ pages

🤖 Generated with Claude Code