Sets up the layered wiki/linked/libs knowledge base described in CLAUDE.md/AGENTS.md, with a frontmatter schema, recursive index/log convention, and conformance lint checks aligned with Google's Open Knowledge Format. Adds two on-demand Claude Code Skills: export-okf (regenerate an OKF-conformant bundle at outputs/okf/) and sync-changes (reconcile this repo's git history with its origin remote, surfacing conflicts to the user). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
1.5 KiB
1.5 KiB
Session Summary — 2026-05-30
Actions Taken
- Transformed
instruction.mdfrom Karpathy-style LLM Wiki prompt to Cascade Knowledge Base concept with layered read-only upstream KBs - Created
wiki/index.md,wiki/overview.md,wiki/log.mdas required core pages - Created
AGENTS.mdandCLAUDE.mdwith full agent instructions - Created
README.mdwith user-facing documentation - Researched 16 improvement ideas from web, wrote to
ideas.md - Added
libs/directory (git-managed copies, read-only, gitignored) - Added
outputs/andtmp/directories - Added Index-First Navigation rule (recursive index.md scanning across all layers)
- Implemented all 14 selected ideas: frontmatter schema (confidence, tldr, quality, supersedes, freshness, retention), entity extraction & graph, lazy-loading index with Use When triggers, TLDR-first query layer, self-healing lint, dual-linking, automation hooks, error book, DDC, inbox workflow
- Created
wiki/graph/,wiki/entities/,raw/inbox/directories - Created
wiki/error-book.mdstub - Restructured
wiki/index.mdinto a routing table - Removed
ideas.mdand its reference from README
Decisions Made
- Cascade priority: wiki/ → linked/ → libs/ (alphabetical within each layer)
- linked/ for symlinks, libs/ for git-cloned copies (both read-only, never touched by agent)
- Local wiki always overrides upstream content
- Frontmatter schema standardized across all wiki pages
- Dual-linking (wikilinks + markdown) required for all cross-references
tmp/,libs/gitignored;outputs/tracked