Michał Kopeć
c56348b15b
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>
24 lines
1.5 KiB
Markdown
24 lines
1.5 KiB
Markdown
# 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
|