ckb/workload/2026-05-30_summary.md
Michał Kopeć c56348b15b Initial commit: Cascade Knowledge Base with OKF-aligned schema and skills
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>
2026-07-13 19:03:50 +02:00

1.5 KiB

Session Summary — 2026-05-30

Actions Taken

  • Transformed instruction.md from 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.md as required core pages
  • Created AGENTS.md and CLAUDE.md with full agent instructions
  • Created README.md with user-facing documentation
  • Researched 16 improvement ideas from web, wrote to ideas.md
  • Added libs/ directory (git-managed copies, read-only, gitignored)
  • Added outputs/ and tmp/ 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.md stub
  • Restructured wiki/index.md into a routing table
  • Removed ideas.md and 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