Skip to content

docs: brain-redesign planning dossiers (pre-grilling)#426

Merged
thinmintdev merged 1 commit into
mainfrom
docs/brain-redesign-planning
Jun 4, 2026
Merged

docs: brain-redesign planning dossiers (pre-grilling)#426
thinmintdev merged 1 commit into
mainfrom
docs/brain-redesign-planning

Conversation

@thinmintdev

Copy link
Copy Markdown
Contributor

What

Nine cross-linked planning documents in docs/internal/brain-redesign/ for a unified-memory "brain" redesign of the hal0 platform: a two-tier system pairing a semantic/episodic engine (Hindsight candidate, replacing Cognee) with a human-legible compiled-knowledge wiki (Hal0ai/hal0-wiki / Karpathy "LLM Wiki" pattern), integrated across every hal0 agent/app/MCP surface and fully self-hosted on Strix Halo.

Doc Purpose
00-INDEX Front door — TL;DR, reading guide, exec summary, glossary
01-hindsight-research Exhaustive Hindsight feature inventory (banks, bank-templates, retain/recall/reflect, webhooks, ops, MCP, integrations)
02-hal0-wiki-research The Obsidian LLM-Wiki framework (skills, vault model, Hermes/Pi/Claude install)
03-current-memory-audit As-built Cognee subsystem with file:line citations
04-consumer-surface Every brain consumer + the deep-integration hook map
05-memory-landscape Paradigm taxonomy, tradeoff matrix, two-tier thesis
06-proposed-architecture The recommendation: layers, MemoryProvider ABC, promotion model
07-integration-roadmap 7 ship-able phases, dependency graph, eval hard-gate
08-grilling-decision-tree Working doc for the grilling session — dependency-ordered decisions, each with a recommended answer + counter-challenge

Why now

Status

Planning only — nothing decided or implemented. Recommendations are opening positions to be stress-tested in a /grill-me session (start at doc 08). Multi-agent research wave, 2026-06-02. Targets v0.4. Will supersede ADR-0005/0014 once decided.

🤖 Generated with Claude Code

Nine cross-linked planning docs for a unified-memory "brain" redesign:
a two-tier system pairing a semantic/episodic engine (Hindsight candidate,
replacing Cognee) with a human-legible compiled-knowledge wiki (hal0-wiki /
Karpathy LLM-Wiki pattern), integrated across every hal0 agent/app/MCP surface
and fully self-hosted on Strix Halo.

- 00 index + exec summary, 01 Hindsight research, 02 hal0-wiki research,
  03 current Cognee audit, 04 consumer surface, 05 memory landscape,
  06 proposed architecture, 07 integration roadmap, 08 grilling decision tree.

Produced 2026-06-02 by a multi-agent research wave. Planning only — nothing
decided or implemented. Doc 08 is the working doc for the post-reboot grilling.

Key corrected findings: #317 namespace bug already fixed (PR #366/#369);
Cognee graph is dead weight (local <32B models can't extract); Hindsight runs
fully local; engine seam is the single CogneeWrapper (no Provider ABC yet);
δ-harness eval is a hard gate before any cutover.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@thinmintdev thinmintdev merged commit 53f8622 into main Jun 4, 2026
4 checks passed
@thinmintdev thinmintdev deleted the docs/brain-redesign-planning branch June 4, 2026 05:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant