Knowledge-Bundles-Framing — paper-brief synthesis (OKF + discipline)
Filed for handoff to the agent writing the llm-wiki-paper.
Reframes the template as an agentic knowledge-bundle system,
using OKF v0.1 terminology as the formalisation anchor and
naming the discipline layer (typed edges, verification gate,
write protocol, KG, federation) as the contribution on top of
the bundle format.
Structure: TL;DR; OKF-anchored terminology; agentic stance;
five-step bundle lifecycle (create/adopt/maintain/federate/
compose); where we extend OKF; cross-cutting properties; honest
limits; naming and positioning for the paper; current
implementation status footer separating shipped vs forward as
of 2026-06-26.
Assumes OKF-Alignment-Ideas recommendations are resolved
(frontmatter superset, OKF-canonical reserved filenames,
[[wikilinks]] body links, posture (c) companion spec for typed
edges). The implementation-status footer makes the forward-
state assumption auditable.
Pages touched:
- Knowledge-Bundles-Framing.md (new, type: synthesis)
- index_llm-wiki-memory-template.md (Applied examples entry)
- Home_llm-wiki-memory-template.md (Applied examples entry)
- 9 See-also back-refs across substrate pages
OKF-Alignment-Ideas — working analysis vs Google's Open Knowledge Format v0.1
Reads the actual SPEC.md (not just the blog post) and folds in
empirical GitHub Wiki link-rendering test results from a
temporary push-then-revert probe. Recommends three changes
(frontmatter superset; drop reserved-filename namespacing once
Obsidian aggregation moves to subdirectory-per-wiki; migrate body
links to [[wikilinks]]) and defers/rejects five others, with the
gate decision pinned to the user's call on the Obsidian-vault
layout.
Pages touched:
- OKF-Alignment-Ideas.md (new, type: analysis, third in the wiki)
- index_llm-wiki-memory-template.md (Applied examples entry)
- Home_llm-wiki-memory-template.md (Applied examples entry)
- Typed-Edges-and-Frontmatter.md (See also back-ref)
- Wiki-LLM-Pattern.md (See also back-ref)
- Sync-Flow.md (See also back-ref)
- Knowledge-Graph-Pipeline.md (See also back-ref)
- Lesson-Parallel-File-Drift.md (See also back-ref)
lint: KG aspirational -> implemented; bidirectional back-references; example cleanup
Stale-claim correction: PR #14 shipped scripts/kg/ (rdflib + pyshacl
in-process KG pipeline) to template main, but nine wiki pages still
described the pipeline as aspirational. Reclassified Knowledge-Graph-
Pipeline to implemented; corrected architecture from Fuseki to rdflib +
pyshacl; flagged the distribution gap (scripts/kg/ not yet in
ALWAYS_FILES, likely to ship as features/kg/ under RFC #13). Updated
Implementation-Status, Wiki-LLM-Pattern, Three-Operations, Typed-Edges-
and-Frontmatter, SCHEMA, Limitation-Inverse-Edges-Missing, Sync-Flow,
and the index to match.
Example cleanup: Wiki-LLM-Pattern line 23 used the placeholder example
[Markov-Chain-v5c2](Markov-Chain-v5c2). Replaced with a real wiki page
name so lint and the KG see a valid edge.
Bidirectional back-references added for the high-value concept <-> lesson
/ limitation pairs (Verification-Gate, Discipline-Gates, Lesson-
Validation-Methodology, Lesson-Parallel-File-Drift, Template-vs-Derived-
Projects, PostToolUse-Hook, Agent-Overlays). Index/log roll-ups
(Implementation-Status, Wiki-Corrections-Log) intentionally left one-way.
Wiki-Corrections-Log entry appended with the receipt.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Flag KG pipeline aspirational; correct none-overlay framing; fix Sync-Flow ALWAYS_FILES; add Implementation-Status + Wiki-Corrections-Log
Reconciles the wiki with the template code on main, where notes-driven
documentation had drifted from what shipped:
- Knowledge-Graph-Pipeline is described across 8 pages as if implemented,
but scripts/kg/build-graph.sh does not exist in the template repo. The
source page now carries a NOT YET IMPLEMENTED banner and a
status: aspirational frontmatter field. Citations on the seven dependent
pages are softened to "designed, not yet implemented" so the aspirational
status is visible at every mention.
- The none "overlay" is not an overlay: --agent=none in instantiate.sh is
a no-install flag, and there is no wiki/agents/none/ directory.
Limitation-Untested-Overlays and Agent-Overlays are reframed accordingly,
separating minimal mode from the two true overlays (claude-code, cursor).
Limitation-Untested-Overlays also corrects a phrasing claim: the README
uses "Shipped but not yet validated" / "Likewise unvalidated", not
"untested-live".
- Sync-Flow's ALWAYS_FILES section was inaccurate: it mixed contents from
four separate arrays and listed the nonexistent scripts/kg/*.sh. Section
rewritten to describe all five arrays (ALWAYS_FILES, CLAUDE_FILES,
CURSOR_FILES, ONE_SHOT_FILES, SUBSTITUTE_FILES) with the file lists
actually present in the sync scripts on main.
New pages:
- Implementation-Status.md: single normative source for what is real today
vs aspirational, with a Partially Implemented bucket for Cursor's
structural-but-not-behavioral validation.
- Wiki-Corrections-Log.md: append-only log of each correction; this commit
is the first entry.
Home and index updated with a "Governance and meta" section linking the
two new pages.
Verification debts noted in the Corrections Log but not corrected this
round: Applied-Example-Microelectronics-Tutor-Demo staleness, the
permission-model claims in Limitation-Prompt-Injection-Residual, and the
existence of chrissweet/llm-wiki-tutor-template cited by Governance.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Initialize wiki: scaffold + first ingest of template knowledge
Scaffolded SCHEMA, Home, index, log, and Home.md redirect to match the
canonical create-mode output of wiki/init-wiki.sh. Authored 18 content
pages across five categories (foundation, mechanisms, lessons,
limitations, applied examples) capturing the wiki-llm pattern, the
template's structure, the contents of PR #1 (discipline gates,
verification gate, PostToolUse hook) and PR #4 (log entry
attribution), the parallel-file-drift / hook-type / validation-method
lessons surfaced by PR review, and the three open limitations
(prompt-injection residual, missing edge inverses per issue #3,
untested non-Claude-Code overlays).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>