-
Notifications
You must be signed in to change notification settings - Fork 2
Implementation Status
Chris Sweet edited this page Jun 12, 2026
·
7 revisions
type: index up: "Home_llm-wiki-memory-template" tags: [status, implementation, governance]
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?"
| 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 |
| 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. |
| 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 |
| 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) |
- Wiki-Corrections-Log: chronological record of corrections made to align the wiki with code reality
- Lesson-Validation-Methodology: how to catch this kind of drift earlier (structural + behavioral validation)