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

[2026-07-14] update | Supplementary link convention on Home

  • by: Chris Sweet via claude-code
  • Codified the rule (per user): for KB repos the supplementary-info (Pages site) link belongs on the wiki Home page, since the Card's home_url resolves to Home
  • Added a Supplementary section to Home_llm-wiki-KB pointing at https://la3d-llm-agents.github.io/llm-wiki-KB/
  • Verified that site is not live yet (HTTP 404; GitHub Pages not enabled on the main repo), so the link is marked "planned; not yet published" rather than presented as live
  • Strengthened the Decision section of Bundle-Pages-and-Supplementary-Data to name Home as the canonical placement

[2026-07-14] update | Supplementary Pages site live

  • by: Chris Sweet via claude-code
  • Stood up the GitHub Pages supplementary site (main repo docs/index.html + .nojekyll), enabled Pages from main:/docs; build succeeded and https://la3d-llm-agents.github.io/llm-wiki-KB/ returns HTTP 200
  • Flipped the Home Supplementary link from "planned; not yet published" to live
  • Recorded the live URL in the Bundle-Pages-and-Supplementary-Data decision

[2026-07-14] update | Document /ask and discovery mode

  • by: Chris Sweet via claude-code
  • Documented the two ask invocation forms in Knowledge-Bundles-Overview and Team-Workflow: the /ask slash command (question needs no quotes) and bash scripts/agent-comms/ask.sh <bundle> "<question>" (question is a single quoted argument)
  • Led with discovery mode: omitting the bundle name makes ask read the federation's agent Cards (descriptions/topics/capabilities) to find a match; /ask selects the match, the script lists candidates to pick
  • Note: /ask is provided by the agent-comms feature (slash-command wrapper over ask.sh); the raw ask.sh ships today, the /ask command is being added via an in-flight PR and is not yet installed in this repo

[2026-07-14] create | How-to: Creating a Knowledge Bundle

  • by: Chris Sweet via claude-code
  • Authored Creating-a-Knowledge-Bundle, an end-to-end procedure (instantiate, author, keep healthy, optional KG, publish, enroll, optional Pages site, consumption) that ties the existing pages together
  • Folded in this session's lessons: text-first bundle rule, the Card YAML colon-quoting gotcha, and the Home-placement Pages convention
  • Documented /ask as shipped (the PR is now merged) alongside ask.sh; discovery mode reads the agent Cards
  • Added back-references from Knowledge-Bundles-Overview, Installation-and-Setup, Team-Workflow; listed under Procedures in index and Home; linked from the Pages site

[2026-07-14] update | Exemplar hardening: typed edges + LICENSE

  • by: Chris Sweet via claude-code
  • Promoted four related: links to specific typed edges where the relationship is genuine: Template-Philosophy extends What-is-the-llm-wiki-Template; Creating-a-Knowledge-Bundle extends Knowledge-Bundles-Overview; Knowledge-Graph and Best-Practices support Template-Philosophy. Modeled the "most-specific edge, don't manufacture crispness" discipline; deliberately added no criticizes edge since no page honestly criticizes another
  • Rebuilt the KG: materialised inverses rose from 1 to 3, confirming the typed edges feed the graph (only spec-declared inverse pairs materialise, per Limitation-Inverse-Edges-Missing)
  • Added a CC BY 4.0 LICENSE to the wiki (bundle content), so the exemplar models the licensing the bundle itself recommends in Team-Workflow
  • Verified back-references exist on all typed-edge targets; wiki remains lint-clean

[2026-07-14] update | Add created-by attribution

  • by: Chris Sweet via claude-code
  • Added a "created by" credit (Chris Sweet, @chrissweet, authored with Claude Code) to the wiki Home, the README, and the Pages footer, supporting the CC BY 4.0 attribution requirement
  • Kept the credit honest about the LLM-authored / human-directed model per Team-Workflow attribution guidance

Clone this wiki locally