Home_llm wiki memory template

---

type: index up: "WIKI-INDEX"

llm-wiki-memory-template

Wiki for the llm-wiki-memory-template repository: a template that gives any project a persistent, LLM-maintained, cross-linked Markdown wiki as durable memory, plus the agent-specific surfaces to make the pattern usable from Claude Code, Cursor, or other coding assistants.

This wiki is itself an instance of the pattern it documents. The pages here capture how the template works, why each piece exists, what we have learned from real PRs and reviews, and what remains open.

Navigation

• Index: full catalog of all wiki pages
• Log: chronological record of wiki updates
• Schema: conventions and operations reference

Foundation

• Wiki-LLM-Pattern: the underlying idea, compounding wiki vs RAG, three-layer architecture
• Three-Operations: Query, Ingest, Lint as the codified agent interface
• Template-vs-Derived-Projects: template scaffolding vs instantiated project
• Governance: three-tier model (base / variant / derived project), when to fork a variant, rebase discipline as variants proliferate
• Agent-Overlays: Claude Code, Cursor, none; same pattern, different surfaces
• Typed-Edges-and-Frontmatter: frontmatter conventions, edges as interface operations

Mechanisms

• Knowledge-Graph-Pipeline (PR #14): scripts/kg/, rdflib + pyshacl in-process; SPARQL over wiki frontmatter, optional Fuseki
• Verification-Gate: four-criteria pre-commit gate (PR #1)
• Discipline-Gates: universal rationalizations always wrong (PR #1)
• PostToolUse-Hook: advisory write-time reminder
• Log-Entry-Attribution: by: line + one commit per entry (PR #4)
• Sync-Flow: the template-manifest sync contract for propagating template updates
• Test-Harness (in review, PR #10): bash test harness + GitHub Actions workflow for structural validation of template changes
• Multi-Agent-Write-Protocol (aspirational): OCC-with-semantic-retry write protocol for wikis with multiple LLM-agent writers; prevents push-level collisions by construction

Lessons learned

• Lesson-Parallel-File-Drift: same content in two files is a footgun
• Lesson-Hook-Type-Matters: prompt-type hooks cannot be advisory
• Lesson-Validation-Methodology: structural + behavioral testing protocol
• Lesson-Template-Contribution-Discipline: four universal rationalizations when AI agents draft PRs against this template (single-writer default, scope creep, speculative PR numbers, state-locking test assertions)
• Lesson-Gitignore-Anchor-Propagation: leading-slash .gitignore anchors travel with the file when synced, silently shadowing derived projects' real paths

Open limitations

• Limitation-Prompt-Injection-Residual: the dominant residual risk
• Limitation-Inverse-Edges-Missing: issue #3, no declared edge inverses
• Limitation-Untested-Overlays: Cursor and none not behaviorally validated

Applied examples

• Applied-Example-Microelectronics-Tutor-Demo: wiki-llm as an undergraduate tutor

• Lessons-Learned-From-model_fusion: field report from a long Claude Code session in PaperAnalyticalDeviceND/model_fusion; surfaces 12 implementation gaps against current template HEAD (0 addressed, 3 partial, 9 missing); recursive-bootstrap finding RESOLVED in PR #25

• Analysis-of-model_fusion-Recommendations: assessment of those 12 recommendations; endorses #1, #4, #8, #9(b) as the high-value cluster (now shipping as PRs #28–#31), pushes back on #2, #6, #10, #11

• Analysis-of-Wiki-Push-Race-Pattern: production collision in web_forager (2026-06-12) reclassifies the Multi-Agent-Write-Protocol prototype from "aspirational" to "empirically needed, wiring is the gap"

• OKF-Alignment-Ideas: working analysis of aligning with Google's Open Knowledge Format v0.1, plus empirical GitHub Wiki link-rendering test results

• Knowledge-Bundles-Framing: paper-brief synthesis reframing the template as an agentic knowledge-bundle system on top of OKF v0.1

• Cursor-Overlay-Validation: first live validation of the Cursor overlay on a real adopting project (2026-06-30); closes the README's "shipped but unvalidated" gap with 4 behavioural tests + 2 non-blocking observations

Governance and meta

• Implementation-Status: current real vs aspirational classification for every wiki page
• Wiki-Corrections-Log: chronological record of corrections made to align the wiki with code

Getting Started

This wiki is human-readable on GitHub or any Markdown renderer. Start at the Index to see all pages organized by category, or read the Schema for conventions when adding new pages.