memory-system

Docs-first система довгострокової пам'яті для агентів і нейромереж, побудована на Markdown-документах, зв'язаних у knowledge graph.

Reading Order

1. idea.md — вихідний задум.
2. system-analysis.md — критичний аналіз ідеї.
3. development-plan.md — загальний roadmap реалізації.
4. architecture-v2.md — архітектура v2: connected memory graph.
5. skills/core/schema-v1.md — формальний контракт v1.
6. skills/core/mem-entity-memory-core.md — high-level правила ядра.
7. implementation-todo.md — поточний checklist.
8. implementation-status.md — статус і прогалини по фазах.

Current State

Наразі repo вже має:

• базову концептуальну документацію;
• formal schema v1;
• стартовий memory vault skeleton;
• перші canonical memory docs;
• templates для типів документів;
• adapter docs для Codex і Claude;
• validator/indexer specs і Python CLI;
• installer для target repos;
• v1 readiness checklist;
• architecture v2 (connected graph, pre-write retrieval pass, computed graph index).

Stable vs Evolving

Already stable (v1)

• типи memory docs
• базовий frontmatter contract
• link semantics
• retrieval budget v1
• write gate
• canonical policy
• validator/indexer Python CLI
• installer workflow

In progress (v2)

• pre-write retrieval pass у write gate
• computed mem-index-graph.md
• shared core для cross-project знань
• soft link-quality warnings

Repo Layout

memory/           project knowledge graph
skills/core/      schema, contracts, specs, governance docs
skills/templates/ document templates
skills/codex/     Codex adapter
skills/claude/    Claude adapter
memory_tool/      Python CLI (validate, index, install)

Tooling

Validate current repo:

python3 -m memory_tool validate --repo-root .

Build lightweight index and write JSON report:

python3 -m memory_tool index --repo-root . --json-out /tmp/memory-index.json

Install memory-system into another repository:

python3 -m memory_tool install --target /path/to/target-repo --content clean
python3 -m memory_tool install --target /path/to/target-repo --content examples

Після install у target repo використовуй:

scripts/memory-tool validate
scripts/memory-tool index --json-out /tmp/memory-index.json