Skip to content

Implementation Status

Chris Sweet edited this page Jun 12, 2026 · 7 revisions

type: index up: "Home_llm-wiki-memory-template" tags: [status, implementation, governance]

Implementation Status

What is actually implemented in the template repo vs what is documented as aspirational. Updated whenever a feature lands, or when a documented feature is found to be unimplemented (in which case it migrates from one section to another and the migration is recorded in Wiki-Corrections-Log).

The wiki was authored after the template code shipped, from project notes. Some pages document the design as imagined rather than the code as written. This page is the reconciliation: the single normative answer to "is this a real feature today?"

Implemented (in code on main)

Feature / page Location in code
Three-Operations (Ingest, Query, Lint) .claude/skills/wiki-*.md, .claude/commands/wiki-*.md, .cursor/rules/wiki-*.mdc
Typed-Edges-and-Frontmatter Convention enforced by procedures and SCHEMA
Verification-Gate wiki/agents/verification-gate.md, referenced from 6 surface files
Discipline-Gates wiki/agents/discipline-gates.md
PostToolUse-Hook (opt-in) wiki/agents/claude-code/templates/posttooluse-hook.sh, installed via setup.sh --posttooluse-hook
Sync-Flow (the ALWAYS_FILES contract itself) scripts/update-from-template.sh, scripts/check-template-version.sh
Knowledge-Graph-Pipeline scripts/kg/ (rdflib + pyshacl in-process; PR #14). Not yet in ALWAYS_FILES; likely to ship as an opt-in feature under features/
Log-Entry-Attribution wiki/init-wiki.sh --agent, the per-overlay skills and commands
Agent-Overlays (claude-code, cursor) wiki/agents/claude-code/, wiki/agents/cursor/, .claude/, .cursor/
Template-vs-Derived-Projects Repo structure plus scripts/instantiate.sh
Governance (three-tier model) Documentation only; no code dependency
Lesson-Hook-Type-Matters Historical observation, encoded into the corrected PostToolUse-Hook
Lesson-Parallel-File-Drift Historical observation, documented in init-wiki.sh MAINTENANCE NOTE
Lesson-Validation-Methodology Documentation only (validation discipline)
Limitation-Prompt-Injection-Residual Documents a real residual risk; not a feature
Applied-Example-Microelectronics-Tutor-Demo External demo project, exists separately

Aspirational (designed, not yet implemented)

Feature / page What is missing Next step
none overlay as a true overlay No wiki/agents/none/ directory --agent=none exists in instantiate.sh as a no-install flag; a true none overlay would document the no-agent path explicitly (probably not warranted)
Inverse typed edges No declared inverse vocabulary in SCHEMA Open issue #3; fix sketched in Limitation-Inverse-Edges-Missing
Multi-Agent-Write-Protocol Production wiring into the agent overlay. The protocol and reference implementation are not the gap. Spec written (push-time-only design with complementary SessionStart auto-pull). Reference implementation shipped at scripts/multi-agent-write-protocol-proto/ via PR #11 (commit 5b5b176); 9 scenarios PASS standalone and via the test harness; CI green on ubuntu-latest + macos-latest. Status reclassified 2026-06-12 from aspirational to empirically needed after a production collision in wiki/web_forager.wiki/ (3-4 human+agent teams; 20 commits of remote drift in the interim; manual log-file reconcile). The wiring PR should: source protocol.sh from the verification gate / ingest skills, install a pre-push git hook in the wiki repo as the mechanical safety net, rename the proto directory to drop the "proto" suffix, and add an LLM-driven resolve_fn for content conflicts. See Analysis-of-Wiki-Push-Race-Pattern for the empirical motivation and the wiring outline.

Partially implemented

Feature / page What works What is missing
Cursor overlay (per Agent-Overlays and Limitation-Untested-Overlays) Files install correctly via wiki/agents/cursor/setup.sh; structurally validated Behavioral validation: no live Cursor session has confirmed the procedures fire as designed

In review (open PR, not yet merged into template main)

Feature / page Where it lives PR
Test-Harness chrissweet/llm-wiki-memory-template branch add-test-harness; scripts/test-mvp/ + .github/workflows/test-harness.yml #10 (addresses issue #5; CI green on ubuntu-latest + macos-latest)

See also

Clone this wiki locally