V3 Memory Unification
Unify 6+ memory systems into AgentDB with HNSW indexing for 150x-12,500x search improvements. Implements ADR-006 (Unified Memory Service) and ADR-009 (Hybrid Memory Backend).
Install
npx skills add https://github.com/spencermarx/open-code-review/tree/main/.claude/skills/v3-memory-unification
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install spencermarx-open-code-review@llmmart
git clone https://github.com/spencermarx/open-code-review.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole spencermarx/open-code-review collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
V3 Memory Unification
What This Skill Does
Consolidates disparate memory systems into unified AgentDB backend with HNSW vector search, achieving 150x-12,500x search performance improvements while maintaining backward compatibility.
Quick Start
# Initialize memory unification
Task("Memory architecture", "Design AgentDB unification strategy", "v3-memory-specialist")
# AgentDB integration
Task("AgentDB setup", "Configure HNSW indexing and vector search", "v3-memory-specialist")
# Data migration
Task("Memory migration", "Migrate SQLite/Markdown to AgentDB", "v3-memory-specialist")
Systems to Unify
Legacy Systems → AgentDB
┌─────────────────────────────────────────┐
│ • MemoryManager (basic operations) │
│ • DistributedMemorySystem (clustering) │
│ • SwarmMemory (agent-specific) │
│ • AdvancedMemoryManager (features) │
│ • SQLiteBackend (structured) │
│ • MarkdownBackend (file-based) │
│ • HybridBackend (combination) │
└─────────────────────────────────────────┘
↓
┌─────────────────────────────────────────┐
│ 🚀 AgentDB with HNSW │
│ • 150x-12,500x faster search │
│ • Unified query interface │
│ • Cross-agent memory sharing │
│ • SONA learning integration │
└─────────────────────────────────────────┘
Implementation Architecture
Unified Memory Service
class UnifiedMemoryService implements IMemoryBackend {
constructor(
private agentdb: AgentDBAdapter,
private indexer: HNSWIndexer,
private migrator: DataMigrator
) {}
async store(entry: MemoryEntry): Promise<void> {
await this.agentdb.store(entry);
await this.indexer.index(entry);
}
async query(query: MemoryQuery): Promise<MemoryEntry[]> {
if (query.semantic) {
return this.indexer.search(query); // 150x-12,500x faster
}
return this.agentdb.query(query);
}
}
HNSW Vector Search
class HNSWIndexer {
constructor(dimensions: number = 1536) {
this.index = new HNSWIndex({
dimensions,
efConstruction: 200,
M: 16,
speedupTarget: '150x-12500x'
});
}
async search(query: MemoryQuery): Promise<MemoryEntry[]> {
const embedding = await this.embedContent(query.content);
const results = this.index.search(embedding, query.limit || 10);
return this.retrieveEntries(results);
}
}
Migration Strategy
Phase 1: Foundation
// AgentDB adapter setup
const agentdb = new AgentDBAdapter({
dimensions: 1536,
indexType: 'HNSW',
speedupTarget: '150x-12500x'
});
Phase 2: Data Migration
// SQLite → AgentDB
const migrateFromSQLite = async () => {
const entries = await sqlite.getAll();
for (const entry of entries) {
const embedding = await generateEmbedding(entry.content);
await agentdb.store({ ...entry, embedding });
}
};
// Markdown → AgentDB
const migrateFromMarkdown = async () => {
const files = await glob('**/*.md');
for (const file of files) {
const content = await fs.readFile(file, 'utf-8');
await agentdb.store({
id: generateId(),
content,
embedding: await generateEmbedding(content),
metadata: { originalFile: file }
});
}
};
SONA Integration
Learning Pattern Storage
class SONAMemoryIntegration {
async storePattern(pattern: LearningPattern): Promise<void> {
await this.memory.store({
id: pattern.id,
content: pattern.data,
metadata: {
sonaMode: pattern.mode,
reward: pattern.reward,
adaptationTime: pattern.adaptationTime
},
embedding: await this.generateEmbedding(pattern.data)
});
}
async retrieveSimilarPatterns(query: string): Promise<LearningPattern[]> {
return this.memory.query({
type: 'semantic',
content: query,
filters: { type: 'learning_pattern' }
});
}
}
Performance Targets
- Search Speed: 150x-12,500x improvement via HNSW
- Memory Usage: 50-75% reduction through optimization
- Query Latency: <100ms for 1M+ entries
- Cross-Agent Sharing: Real-time memory synchronization
- SONA Integration: <0.05ms adaptation time
Success Metrics
- All 7 legacy memory systems migrated to AgentDB
- 150x-12,500x search performance validated
- 50-75% memory usage reduction achieved
- Backward compatibility maintained
- SONA learning patterns integrated
- Cross-agent memory sharing operational
Files (open-code-review)
-
SKILL.md 5.1 KB
--- name: "V3 Memory Unification" description: "Unify 6+ memory systems into AgentDB with HNSW indexing for 150x-12,500x search improvements. Implements ADR-006 (Unified Memory Service) and ADR-009 (Hybrid Memory Backend)." --- # V3 Memory Unification ## What This Skill Does Consolidates disparate memory systems into unified AgentDB backend with HNSW vector search, achieving 150x-12,500x search performance improvements while maintaining backward compatibility. ## Quick Start ```bash # Initialize memory unification Task("Memory architecture", "Design AgentDB unification strategy", "v3-memory-specialist") # AgentDB integration Task("AgentDB setup", "Configure HNSW indexing and vector search", "v3-memory-specialist") # Data migration Task("Memory migration", "Migrate SQLite/Markdown to AgentDB", "v3-memory-specialist") ``` ## Systems to Unify ### Legacy Systems → AgentDB ``` ┌─────────────────────────────────────────┐ │ • MemoryManager (basic operations) │ │ • DistributedMemorySystem (clustering) │ │ • SwarmMemory (agent-specific) │ │ • AdvancedMemoryManager (features) │ │ • SQLiteBackend (structured) │ │ • MarkdownBackend (file-based) │ │ • HybridBackend (combination) │ └─────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────┐ │ 🚀 AgentDB with HNSW │ │ • 150x-12,500x faster search │ │ • Unified query interface │ │ • Cross-agent memory sharing │ │ • SONA learning integration │ └─────────────────────────────────────────┘ ``` ## Implementation Architecture ### Unified Memory Service ```typescript class UnifiedMemoryService implements IMemoryBackend { constructor( private agentdb: AgentDBAdapter, private indexer: HNSWIndexer, private migrator: DataMigrator ) {} async store(entry: MemoryEntry): Promise<void> { await this.agentdb.store(entry); await this.indexer.index(entry); } async query(query: MemoryQuery): Promise<MemoryEntry[]> { if (query.semantic) { return this.indexer.search(query); // 150x-12,500x faster } return this.agentdb.query(query); } } ``` ### HNSW Vector Search ```typescript class HNSWIndexer { constructor(dimensions: number = 1536) { this.index = new HNSWIndex({ dimensions, efConstruction: 200, M: 16, speedupTarget: '150x-12500x' }); } async search(query: MemoryQuery): Promise<MemoryEntry[]> { const embedding = await this.embedContent(query.content); const results = this.index.search(embedding, query.limit || 10); return this.retrieveEntries(results); } } ``` ## Migration Strategy ### Phase 1: Foundation ```typescript // AgentDB adapter setup const agentdb = new AgentDBAdapter({ dimensions: 1536, indexType: 'HNSW', speedupTarget: '150x-12500x' }); ``` ### Phase 2: Data Migration ```typescript // SQLite → AgentDB const migrateFromSQLite = async () => { const entries = await sqlite.getAll(); for (const entry of entries) { const embedding = await generateEmbedding(entry.content); await agentdb.store({ ...entry, embedding }); } }; // Markdown → AgentDB const migrateFromMarkdown = async () => { const files = await glob('**/*.md'); for (const file of files) { const content = await fs.readFile(file, 'utf-8'); await agentdb.store({ id: generateId(), content, embedding: await generateEmbedding(content), metadata: { originalFile: file } }); } }; ``` ## SONA Integration ### Learning Pattern Storage ```typescript class SONAMemoryIntegration { async storePattern(pattern: LearningPattern): Promise<void> { await this.memory.store({ id: pattern.id, content: pattern.data, metadata: { sonaMode: pattern.mode, reward: pattern.reward, adaptationTime: pattern.adaptationTime }, embedding: await this.generateEmbedding(pattern.data) }); } async retrieveSimilarPatterns(query: string): Promise<LearningPattern[]> { return this.memory.query({ type: 'semantic', content: query, filters: { type: 'learning_pattern' } }); } } ``` ## Performance Targets - **Search Speed**: 150x-12,500x improvement via HNSW - **Memory Usage**: 50-75% reduction through optimization - **Query Latency**: <100ms for 1M+ entries - **Cross-Agent Sharing**: Real-time memory synchronization - **SONA Integration**: <0.05ms adaptation time ## Success Metrics - [ ] All 7 legacy memory systems migrated to AgentDB - [ ] 150x-12,500x search performance validated - [ ] 50-75% memory usage reduction achieved - [ ] Backward compatibility maintained - [ ] SONA learning patterns integrated - [ ] Cross-agent memory sharing operational
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.