Skip to content

Add Memory service architecture documentation#78

Open
emerson-gray wants to merge 2 commits intomainfrom
memory-architecture-docs
Open

Add Memory service architecture documentation#78
emerson-gray wants to merge 2 commits intomainfrom
memory-architecture-docs

Conversation

@emerson-gray
Copy link
Copy Markdown
Collaborator

Summary

Adds architecture documentation for the Memory platform service — a per-agent memory system with learned activation, hook-based injection, and score-driven lifecycle.

Changes

New file

  • architecture/memory.md — Full architecture spec covering:
    • Data model: Memory, Key (repo + context), Content (text + priority)
    • Memory creation via dedicated agent tool
    • Activation function: trained model, top-K + threshold selection
    • Injection via hooks with deduplication/context tracking
    • Scoring: agent-provided [0, 1] feedback, timed at end of memory lifetime
    • Score-driven lifecycle (no explicit update/delete)
    • Open questions: key serialization format, memory lifetime and session boundary (three candidate approaches)

Updated files

  • README.md — Added Memory to the architecture document table
  • architecture/system-overview.md — Added Memory to the component diagram (Data Plane) and component summary table

- Add architecture/memory.md: full spec for the Memory platform service
  covering data model, activation function, hook-based injection,
  deduplication, scoring, and score-driven lifecycle
- Update README.md: add Memory to architecture document table
- Update system-overview.md: add Memory to component diagram and
  component summary table
- Document open questions: key serialization format, memory lifetime
  and session boundary (three candidate approaches)
- Cold start: agent provides positive/negative key examples at creation
- Activation model architecture: pretrained encoder + per-agent trainable head
- Label storage section under Scoring
- New open questions: label storage, per-agent model storage,
  encoder selection, training update strategy
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