Skip to content

log_llm wiki KB

Jump to bottom
Chris Sweet edited this page Jul 14, 2026 · 15 revisions

type: index up: "Home_llm-wiki-KB"

Log — llm-wiki-KB

Chronological record of wiki activity.

[2026-07-14] create | Wiki initialized

  • by: Chris Sweet via claude-code
  • Created wiki structure with namespaced navigation files
  • Ready for first ingest

[2026-07-14] create | Bundle philosophy/orientation pages

  • by: Chris Sweet via claude-code
  • Authored What-is-the-llm-wiki-Template (anchor), Template-Philosophy, When-to-Use-When-Not, Knowledge-Bundles-Overview from the seed at docs/llm-wiki-template-bundle-seeds.md
  • Sources: template repo README/CLAUDE snippet/llm-wiki.md, template's own wiki (Wiki-LLM-Pattern, Three-Operations, Knowledge-Bundles-Framing, OKF-Alignment-Ideas), the WGRA flyer, and the vision wiki (Vision, Knowledge-Expertise-Experience, Knowledge-Bundles, Retrieval-Context-Envelope)
  • Marked aspirational/planned items honestly: OKF import/export at analysis stage; vision-wiki concepts (context envelope, retrieval/reasoning-hop, Matrix analogy) flagged as framing not shipped mechanics
  • Updated index_llm-wiki-KB.md and Home_llm-wiki-KB.md category nav

[2026-07-14] create | Bundle reference/structure pages

  • by: Chris Sweet via claude-code
  • Authored Wiki-Structure-and-Conventions, Best-Practices, Knowledge-Graph from the seed
  • Sources: this bundle's SCHEMA_llm-wiki-KB.md and Edge-Types.md, scripts/kg/README.md, the discipline-gates and verification-gate agent docs, the template wiki's Knowledge-Graph-Pipeline and Typed-Edges-and-Frontmatter, and the vision wiki's Lightweight-Structural-Graphs
  • Noted honestly: area: is not a standard authored field in this template (tags plays that role, area is KG-materialized); scripts/kg/ is present here but not in the template's ALWAYS_FILES sync contract

[2026-07-14] create | Bundle procedural pages

  • by: Chris Sweet via claude-code
  • Authored Installation-and-Setup, Everyday-Operations, Team-Workflow, Extending-the-Template, Troubleshooting from the seed
  • Sources: template README (instantiate.sh paths, agents, update-from-template), the Claude Code overlay setup.sh and ensure-wiki.py, the wiki-source/experiment/lint skills and commands, the multi-agent write protocol and wiki-write-protocol docs, features/README.md + adding-a-feature.md + agent-comms CLAUDE.section
  • Corrections vs seed: KG uses rdflib+pyshacl in-process, not arq (arq only on optional Jena/Fuseki path); write protocol reference impl shipped but not yet wired into default write path; Cursor overlay structural-only; wiki licensing and per-page student access not specified by the template

[2026-07-14] create | Bundle glossary page

  • by: Chris Sweet via claude-code
  • Authored Concepts-Glossary last so it reflects terms actually used across the other 12 pages
  • Sources: vision wiki (Markov/RWR/personalized PageRank, entity resolution, structural-vs-content graph, KEE, extended mind, DIKW, tacit/procedural/declarative knowledge, deliberate practice), scripts/kg/README.md (RDF Turtle, RDF-star, JSON-LD, SHACL, SPARQL, rdflib/pyshacl, Fuseki), and this bundle's own pages for template/process terms
  • Ran the Verification Gate over all 13 pages: confirmed every genuine cross-reference resolves, frontmatter valid with type/up, numbers are structural facts (file/predicate/query counts) not projections, and aspirational features marked honestly
  • Completes the 13-page bundle defined in docs/llm-wiki-template-bundle-seeds.md

[2026-07-14] create | Federation Card (agent-comms enrollment)

  • by: Chris Sweet via claude-code
  • Enabled the agent-comms feature and ran enroll.sh to publish Card_llm-wiki-KB.md so this bundle appears in the LA3D-LLM-Agents federation index
  • Root cause it fixes: instantiation does not auto-enroll; the feature was never enabled and no Card existed, so the daily rebuild had nothing to project even though the repo is in the trusted org
  • Card declares id chrissweet/llm-wiki-KB, a description, three capabilities, and topics; repo org membership (LA3D-LLM-Agents) satisfies the discovery gate, so no nd-llm-wiki topic is required
  • Added index Federation entry for the Card

[2026-07-14] update | Fix Card frontmatter YAML

  • by: Chris Sweet via claude-code
  • First federation rebuild discovered the Card (via org) but skipped it: "YAML parse error ... mapping values are not allowed here"
  • Cause: enroll.sh wrote the description unquoted, and the description contained a colon, so YAML read ": " as a nested mapping
  • Fix: quoted the description value; validated the frontmatter parses with yaml.safe_load
  • Underlying enroll.sh bug worth reporting upstream: it should quote user-entered description/capabilities that may contain colons

[2026-07-14] create | Decision: Bundle Pages and Supplementary Data

  • by: Chris Sweet via claude-code
  • Filed Bundle-Pages-and-Supplementary-Data (type: decision): text-first bundle in the wiki repo vs GitHub Pages (main repo) for supplementary data/images/demos, scoped as a conditional best practice for bundle-primary repos in a github.io environment
  • Verified the federation mechanism against LA3D-LLM-Agents/la3d-llm-agents.github.io scripts/build-index.py project() (lines 175-193): home_url/card_url/wiki_clone_url are hard-derived from owner/name and NOT overridable; only id/description/topics/capabilities/endpoints project from the Card; no resource/site URL field exists, so a Pages URL cannot be surfaced through the Card today
  • Interim guidance recorded: link the Pages site from the wiki Home body (home_url lands there); revisit if build-index.py adds a resource/home_page projection
  • Added back-references from Knowledge-Bundles-Overview, Best-Practices, Team-Workflow; new Decisions category in index and Home

Clone this wiki locally